> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paysway.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get account verification

> Retrieves the current state and results of an account verification by its ID.  When the verification is complete, the result can include beneficiary name verification, account status check, and additional data depending on the payment corridor.




## OpenAPI

````yaml /api-reference/paysway-api.yaml get /payments/verifications/{verificationId}
openapi: 3.1.0
info:
  title: PaySway API
  version: 1.2.0
servers:
  - url: https://api.paysway.dev
    description: Development environment
  - url: https://api.paysway.io
    description: Production environment
security: []
paths:
  /payments/verifications/{verificationId}:
    get:
      tags:
        - Payment Preparation
      summary: Get account verification
      description: >
        Retrieves the current state and results of an account verification by
        its ID.  When the verification is complete, the result can include
        beneficiary name verification, account status check, and additional data
        depending on the payment corridor.
      parameters:
        - name: verificationId
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Account verification details returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountVerification'
      security:
        - oauth2ClientCredentials: []
components:
  schemas:
    AccountVerification:
      type: object
      properties:
        id:
          type: string
          format: uuid
        createdDate:
          type: string
          format: date-time
        updatedDate:
          type: string
          format: date-time
        state:
          $ref: '#/components/schemas/AccountVerificationState'
        result:
          $ref: '#/components/schemas/AccountVerificationResult'
        failureReason:
          type: string
          enum:
            - INVALID_FIELD
            - UNAVAILABLE_FINANCIAL_INSTITUTION
            - UNSUPPORTED_FINANCIAL_INSTITUTION
            - UNEXPECTED_ERROR
        metadata:
          $ref: '#/components/schemas/Metadata'
      required:
        - id
        - createdDate
        - updatedDate
        - state
    AccountVerificationState:
      type: string
      enum:
        - PENDING
        - COMPLETED
        - FAILED
    AccountVerificationResult:
      type: object
      properties:
        accountStatus:
          type: string
          enum:
            - ACTIVE
            - NOT_FOUND
            - FORBIDDEN
        accountHolderName:
          $ref: '#/components/schemas/AccountHolderNameVerification'
        accountType:
          $ref: '#/components/schemas/AccountTypeVerification'
        schemeResponseCode:
          type: string
          enum:
            - EPC_VOP_MTCH
            - EPC_VOP_CMTC
            - EPC_VOP_NMTC
            - EPC_VOP_NOAP
            - UK_COP_ANNM
            - UK_COP_MBAM
            - UK_COP_BANM
            - UK_COP_PANM
            - UK_COP_BAMM
            - UK_COP_PAMM
            - UK_COP_AC01
            - UK_COP_IVCR
            - UK_COP_ACNS
            - UK_COP_OPTO
            - UK_COP_CASS
            - UK_COP_SCNS
      required:
        - accountStatus
    Metadata:
      type: object
      description: |
        Arbitrary key-value pairs
      additionalProperties:
        type: string
        maxLength: 250
    AccountHolderNameVerification:
      type: object
      properties:
        verifiedName:
          type: string
        matchStatus:
          $ref: '#/components/schemas/NameMatchStatus'
    AccountTypeVerification:
      type: object
      properties:
        matchStatus:
          $ref: '#/components/schemas/AccountTypeMatchStatus'
    NameMatchStatus:
      type: string
      enum:
        - FULL_MATCH
        - PARTIAL_MATCH
        - NO_MATCH
    AccountTypeMatchStatus:
      type: string
      enum:
        - MATCH
        - NO_MATCH
  securitySchemes:
    oauth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /oauth2/token
          scopes: {}

````