Envestnet Verification APIs — Verification

naftiko: 1.0.0-alpha2
info:
  label: Envestnet Verification APIs — Verification
  description: 'Envestnet Verification APIs — Verification. 5 operations. Lead operation: Envestnet Get Verification Status.
    Self-contained Naftiko capability covering one Envestnet business surface.'
  tags:
  - Envestnet
  - Verification
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ENVESTNET_API_KEY: ENVESTNET_API_KEY
capability:
  consumes:
  - type: http
    namespace: verification-verification
    baseUri: ''
    description: Envestnet Verification APIs — Verification business capability. Self-contained, no shared references.
    resources:
    - name: verification
      path: /verification
      operations:
      - name: getverificationstatus
        method: GET
        description: Envestnet 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: Envestnet Verify Challenge Deposit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: initiatematchingorchallengedepositeverification
        method: POST
        description: Envestnet Initiaite Challenge Deposit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: verification-holderProfile
      path: /verification/holderProfile
      operations:
      - name: getholderprofile
        method: GET
        description: Envestnet 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: Envestnet 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: verification-verification-rest
    port: 8080
    description: REST adapter for Envestnet Verification 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: GET
        name: getverificationstatus
        description: Envestnet Get Verification Status
        call: verification-verification.getverificationstatus
        with:
          accountId: rest.accountId
          providerAccountId: rest.providerAccountId
          verificationType: rest.verificationType
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: verifychallengedeposit
        description: Envestnet Verify Challenge Deposit
        call: verification-verification.verifychallengedeposit
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: initiatematchingorchallengedepositeverification
        description: Envestnet Initiaite Challenge Deposit
        call: verification-verification.initiatematchingorchallengedepositeverification
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/verification/holderprofile
      name: verification-holderprofile
      description: REST surface for verification-holderProfile.
      operations:
      - method: GET
        name: getholderprofile
        description: Envestnet Get Holder Profile
        call: verification-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: Envestnet Get Verified Accounts
        call: verification-verification.getverifiedaccounts
        with:
          accountId: rest.accountId
          isSelected: rest.isSelected
          providerAccountId: rest.providerAccountId
          verificationStatus: rest.verificationStatus
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: verification-verification-mcp
    port: 9090
    transport: http
    description: MCP adapter for Envestnet Verification APIs — Verification. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: envestnet-get-verification-status
      description: Envestnet Get Verification Status
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: verification-verification.getverificationstatus
      with:
        accountId: tools.accountId
        providerAccountId: tools.providerAccountId
        verificationType: tools.verificationType
      outputParameters:
      - type: object
        mapping: $.
    - name: envestnet-verify-challenge-deposit
      description: Envestnet Verify Challenge Deposit
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: verification-verification.verifychallengedeposit
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: envestnet-initiaite-challenge-deposit
      description: Envestnet Initiaite Challenge Deposit
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: verification-verification.initiatematchingorchallengedepositeverification
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: envestnet-get-holder-profile
      description: Envestnet Get Holder Profile
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: verification-verification.getholderprofile
      with:
        accountId: tools.accountId
        providerAccountId: tools.providerAccountId
      outputParameters:
      - type: object
        mapping: $.
    - name: envestnet-get-verified-accounts
      description: Envestnet Get Verified Accounts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: verification-verification.getverifiedaccounts
      with:
        accountId: tools.accountId
        isSelected: tools.isSelected
        providerAccountId: tools.providerAccountId
        verificationStatus: tools.verificationStatus
      outputParameters:
      - type: object
        mapping: $.