Yodlee Core APIs — Verification

naftiko: 1.0.0-alpha2
info:
  label: Yodlee Core APIs — Verification
  description: 'Yodlee Core APIs — Verification. 6 operations. Lead operation: Initiaite Challenge Deposit. Self-contained
    Naftiko capability covering one Yodlee business surface.'
  tags:
  - Yodlee
  - Verification
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    YODLEE_API_KEY: YODLEE_API_KEY
capability:
  consumes:
  - type: http
    namespace: core-verification
    baseUri: ''
    description: Yodlee Core APIs — Verification business capability. Self-contained, no shared references.
    resources:
    - name: verification
      path: /verification
      operations:
      - name: initiatematchingorchallengedepositeverification
        method: POST
        description: Initiaite Challenge Deposit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: verificationParam
          in: body
          type: string
          description: verification information
          required: true
      - name: getverificationstatus
        method: GET
        description: Get Verification Status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: accountId
          in: query
          type: string
          description: Comma separated accountId
        - name: providerAccountId
          in: query
          type: string
          description: Comma separated providerAccountId
        - name: verificationType
          in: query
          type: string
          description: verificationType
      - name: verifychallengedeposit
        method: PUT
        description: Verify Challenge Deposit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: verificationParam
          in: body
          type: string
          description: verification information
          required: true
    - name: verification-classification-summary
      path: /verification/classification/summary
      operations:
      - name: getclassificationsummary
        method: GET
        description: Get Classification Summary
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: accountId
          in: query
          type: string
          description: accountId
          required: true
    - name: verification-holderProfile
      path: /verification/holderProfile
      operations:
      - name: getholderprofile
        method: GET
        description: Get Holder Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: accountId
          in: query
          type: string
          description: accountId
        - name: providerAccountId
          in: query
          type: string
          description: providerAccountId.
          required: true
    - name: verification-verifiedAccounts
      path: /verification/verifiedAccounts
      operations:
      - name: getverifiedaccounts
        method: GET
        description: Get Verified Accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: accountId
          in: query
          type: string
          description: Comma separated accountIds.
        - name: isSelected
          in: query
          type: string
          description: Comma separated isSelected. Allowed values are true, false. <br>
        - name: providerAccountId
          in: query
          type: string
          description: providerAccountId.
          required: true
        - name: verificationStatus
          in: query
          type: string
          description: Comma separated verificationStatus. Allowed values are SUCCESS, FAILED <br><b>Note:</b> If no value
            is passed, the implicit default value is SUCCESS.
  exposes:
  - type: rest
    namespace: core-verification-rest
    port: 8080
    description: REST adapter for Yodlee Core APIs — Verification. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/verification
      name: verification
      description: REST surface for verification.
      operations:
      - method: POST
        name: initiatematchingorchallengedepositeverification
        description: Initiaite Challenge Deposit
        call: core-verification.initiatematchingorchallengedepositeverification
        with:
          verificationParam: rest.verificationParam
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getverificationstatus
        description: Get Verification Status
        call: core-verification.getverificationstatus
        with:
          accountId: rest.accountId
          providerAccountId: rest.providerAccountId
          verificationType: rest.verificationType
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: verifychallengedeposit
        description: Verify Challenge Deposit
        call: core-verification.verifychallengedeposit
        with:
          verificationParam: rest.verificationParam
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/verification/classification/summary
      name: verification-classification-summary
      description: REST surface for verification-classification-summary.
      operations:
      - method: GET
        name: getclassificationsummary
        description: Get Classification Summary
        call: core-verification.getclassificationsummary
        with:
          accountId: rest.accountId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/verification/holderprofile
      name: verification-holderprofile
      description: REST surface for verification-holderProfile.
      operations:
      - method: GET
        name: getholderprofile
        description: Get Holder Profile
        call: core-verification.getholderprofile
        with:
          accountId: rest.accountId
          providerAccountId: rest.providerAccountId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/verification/verifiedaccounts
      name: verification-verifiedaccounts
      description: REST surface for verification-verifiedAccounts.
      operations:
      - method: GET
        name: getverifiedaccounts
        description: Get Verified Accounts
        call: core-verification.getverifiedaccounts
        with:
          accountId: rest.accountId
          isSelected: rest.isSelected
          providerAccountId: rest.providerAccountId
          verificationStatus: rest.verificationStatus
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: core-verification-mcp
    port: 9090
    transport: http
    description: MCP adapter for Yodlee Core APIs — Verification. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: initiaite-challenge-deposit
      description: Initiaite Challenge Deposit
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: core-verification.initiatematchingorchallengedepositeverification
      with:
        verificationParam: tools.verificationParam
      outputParameters:
      - type: object
        mapping: $.
    - name: get-verification-status
      description: Get Verification Status
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: core-verification.getverificationstatus
      with:
        accountId: tools.accountId
        providerAccountId: tools.providerAccountId
        verificationType: tools.verificationType
      outputParameters:
      - type: object
        mapping: $.
    - name: verify-challenge-deposit
      description: Verify Challenge Deposit
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: core-verification.verifychallengedeposit
      with:
        verificationParam: tools.verificationParam
      outputParameters:
      - type: object
        mapping: $.
    - name: get-classification-summary
      description: Get Classification Summary
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: core-verification.getclassificationsummary
      with:
        accountId: tools.accountId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-holder-profile
      description: Get Holder Profile
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: core-verification.getholderprofile
      with:
        accountId: tools.accountId
        providerAccountId: tools.providerAccountId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-verified-accounts
      description: Get Verified Accounts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: core-verification.getverifiedaccounts
      with:
        accountId: tools.accountId
        isSelected: tools.isSelected
        providerAccountId: tools.providerAccountId
        verificationStatus: tools.verificationStatus
      outputParameters:
      - type: object
        mapping: $.