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

# Get Verification

> Retrieve the result of a previous test verification.

<Note>
  **Sandbox Behavior:** This endpoint returns the actual result of a previous Sandbox POST request if the ID matches.
</Note>

For any valid UUID provided, the verification outcome is determined by the last digit of the id you provide. This allows you to test different integration flows easily.

| Last Digit | `status`    | `match_result` | Use Case                   |
| :--------- | :---------- | :------------- | :------------------------- |
| `1`        | `completed` | `match`        | Successful verification    |
| `2`        | `completed` | `no_match`     | Name discrepancy           |
| `3`        | `completed` | `close_match`  | Minor typo / Partial match |
| `4`        | `failed`    | `null`         | Technical/Bank error       |

For example, to simulate a **Close Match**, use an ID ending in `3`:


## OpenAPI

````yaml GET /sandbox/account-holder-verifications/{id}
openapi: 3.0.0
info:
  title: Ibantrack API
  description: IBAN account holder verification API
  version: 1.0.0
servers:
  - url: https://api.ibantrack.com/api-v1
    description: Production
security: []
paths:
  /sandbox/account-holder-verifications/{id}:
    get:
      tags:
        - Sandbox
      summary: Get Verification
      operationId: getSandboxAccountHolderVerification
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Verification completed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerificationResponse'
              examples:
                Match:
                  $ref: '#/components/examples/MatchResult'
                No match:
                  $ref: '#/components/examples/NoMatchResult'
                Close Match:
                  $ref: '#/components/examples/CloseMatchResult'
                Account Not Verifiable:
                  $ref: '#/components/examples/AccountNotVerifiableResult'
                Institution out of scope:
                  $ref: '#/components/examples/OutOfScope'
      security:
        - bearerAuth: []
components:
  schemas:
    VerificationResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
          example: abc123ab-3171-4e97-92ec-a11e9fabc123
        status:
          type: string
          readOnly: true
          enum:
            - pending
            - completed
            - failed
          description: >-
            The current lifecycle state of the verification request. 

             A `completed` status indicates that the financial institution has been successfully reached and processed the request. 

            A `failed`status indicates that the verification could not be
            completed due to technical or institutional constraints. 


            Additional details may be provided in the `status_reason` field.
        match_result:
          type: string
          readOnly: true
          enum:
            - match
            - close_match
            - no_match
            - account_not_verifiable
          description: >-
            The outcome of the account holder name verification against the
            financial institution’s records. Provided only when `status`is
            `completed`.
        matched_name:
          type: string
          readOnly: true
          example: JEAN DUPONT
          description: >-
            Indicates the full name or company name as registered by the
            financial institution. Provided only if 'match_result' is
            'close_match' and in accordance with data privacy regulations.
        status_reason:
          type: string
          readOnly: true
          description: >-
            Additional context on the request status. Primarily populated when
            status is 'failed' or when match_result is 'account_not_verifiable'
          example: institution_timeout
        enrichment:
          type: object
          readOnly: true
          properties:
            status:
              type: string
              description: >-
                Additional data derived from the IBAN. Currently available only
                for French IBANs. Not available in sandbox mode.
              example: completed
            bic_code:
              type: object
              readOnly: true
              properties:
                value:
                  type: string
                  readOnly: true
                  example: BNPAFRPPXXX
                status:
                  type: string
                  readOnly: true
                  enum:
                    - pending
                    - completed
                    - unavailable
                    - not_applicable
                  example: completed
            bank_name:
              type: object
              readOnly: true
              properties:
                value:
                  type: string
                  readOnly: true
                  example: BNP PARIBAS
                status:
                  type: string
                  readOnly: true
                  enum:
                    - pending
                    - completed
                    - unavailable
                    - not_applicable
                  example: completed
  examples:
    MatchResult:
      summary: Match
      value:
        id: abc123ab-3171-4e97-92ec-a11e9fabc123
        status: completed
        match_result: match
    NoMatchResult:
      summary: No match
      value:
        id: abc123ab-3171-4e97-92ec-a11e9fabc123
        status: completed
        match_result: no_match
    CloseMatchResult:
      summary: Close match
      value:
        id: abc123ab-3171-4e97-92ec-a11e9fabc123
        status: completed
        match_result: close_match
        matched_name: JEAN DUCLOS
    AccountNotVerifiableResult:
      summary: Account not verifiable
      value:
        id: abc123ab-3171-4e97-92ec-a11e9fabc123
        status: completed
        match_result: account_not_verifiable
        status_reason: verification_not_possible
    OutOfScope:
      summary: Institution out of scope
      value:
        id: abc123ab-3171-4e97-92ec-a11e9fabc123
        status: failed
        status_reason: institution_out_of_scope
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````