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

# Verify an External Account

> Trigger a verification check for an external account. Verifies that the `account_owner_name` matches the actual account holder at the receiving bank.

Supported for `iban` (EUR) and `gb` (GBP) account types only. Does not require an Idempotency-Key header.

After triggering, poll the external account's `account_verification` field until `completed_at` is populated.




## OpenAPI

````yaml https://withbridge-image1-sv-usw2-monorail-openapi.s3.amazonaws.com/latest.json post /customers/{customerID}/external_accounts/{externalAccountID}/verify
openapi: 3.0.2
info:
  title: Bridge API
  description: APIs to move into, out of, and between any form of a dollar
  version: '1'
servers:
  - url: https://api.bridge.xyz/v0
    description: The base path for all resources
security:
  - ApiKey: []
tags:
  - name: Customers
  - name: Fiat Payout Configuration
  - name: External Accounts
  - name: Transfers
  - name: Prefunded Accounts
  - name: Balances
  - name: Liquidation Addresses
  - name: Developers
  - name: API Keys
  - name: Plaid
  - name: Virtual Accounts
  - name: Static Memos
  - name: Cards
  - name: Funds Requests
  - name: Webhooks
  - name: Lists
  - name: Crypto Return Policies
  - name: Rewards
  - name: Associated Persons
  - name: Sandbox
paths:
  /customers/{customerID}/external_accounts/{externalAccountID}/verify:
    post:
      tags:
        - External Accounts
      summary: Verify an External Account
      description: >
        Trigger a verification check for an external account. Verifies that the
        `account_owner_name` matches the actual account holder at the receiving
        bank.


        Supported for `iban` (EUR) and `gb` (GBP) account types only. Does not
        require an Idempotency-Key header.


        After triggering, poll the external account's `account_verification`
        field until `completed_at` is populated.
      parameters:
        - $ref: '#/components/parameters/CustomerIDParameter'
        - $ref: '#/components/parameters/ExternalAccountIDParameter'
      responses:
        '200':
          description: Verification initiated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  account_type:
                    type: string
                    enum:
                      - iban
                      - gb
                    description: The account type that was verified.
                  account_verification:
                    description: The current state of the verification.
                    type: object
                    properties:
                      iban:
                        type: object
                        description: Present when verifying an IBAN account.
                        properties:
                          match_level:
                            type: string
                            enum:
                              - pending
                              - match
                              - close_match
                              - no_match
                              - error
                            description: The result of the name match check.
                          reason_code:
                            type: string
                            nullable: true
                            description: >-
                              Additional context from the receiving bank when
                              the result is not a full match.
                          validated_account_owner_name:
                            type: string
                            nullable: true
                            description: The name on file at the receiving bank.
                      gb:
                        type: object
                        description: Present when verifying a GB account.
                        properties:
                          match_level:
                            type: string
                            enum:
                              - pending
                              - match
                              - close_match
                              - no_match
                              - error
                            description: The result of the name match check.
                          reason_code:
                            type: string
                            nullable: true
                            description: >-
                              Additional context from the receiving bank when
                              the result is not a full match.
                          validated_account_owner_name:
                            type: string
                            nullable: true
                            description: The name on file at the receiving bank.
                      requested_at:
                        type: string
                        format: date-time
                        description: When the verification was requested.
                      completed_at:
                        type: string
                        format: date-time
                        nullable: true
                        description: When the verification completed. Null while pending.
              examples:
                PendingIbanVerification:
                  summary: A newly triggered IBAN verification
                  value:
                    account_type: iban
                    account_verification:
                      iban:
                        match_level: pending
                        reason_code: null
                        validated_account_owner_name: null
                      requested_at: '2026-01-15T12:00:00.000Z'
                      completed_at: null
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/AuthenticationError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '409':
          description: A verification is already in progress for this external account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          $ref: '#/components/responses/UnexpectedError'
components:
  parameters:
    CustomerIDParameter:
      name: customerID
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Id'
    ExternalAccountIDParameter:
      name: externalAccountID
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Id'
  responses:
    BadRequestError:
      description: Request containing missing or invalid parameters.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            BadCustomerRequestErrorExample:
              summary: Bad customer request
              value:
                code: bad_customer_request
                message: fields missing from customer body.
                name: first_name,ssn
    AuthenticationError:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            MissingTokenError:
              summary: No Api-Key header
              description: The header may be missing or misspelled.
              value:
                code: required
                location: header
                name: Api-Key
                message: Missing Api-Key header
            InvalidTokenError:
              summary: Invalid key in Api-Key header
              value:
                code: invalid
                location: header
                name: Api-Key
                message: Invalid Api-Key header
    NotFoundError:
      description: No resource found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            NotFoundErrorExample:
              summary: Invalid customer id
              value:
                code: Invalid
                message: Unknown customer id
    UnexpectedError:
      description: Unexpected error. User may try and send the request again.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            UnexpectedError:
              summary: An unexpected error
              value:
                errors:
                  - code: unexpected
                    message: An expected error occurred, you may try again later
  schemas:
    Error:
      required:
        - code
        - message
      properties:
        code:
          type: string
          minLength: 1
          maxLength: 256
        message:
          type: string
          minLength: 1
          maxLength: 512
        source:
          title: ErrorSource
          required:
            - location
            - key
          properties:
            location:
              type: string
              enum:
                - path
                - query
                - body
                - header
            key:
              type: string
              description: >-
                Comma separated names of the properties or parameters causing
                the error
    Id:
      description: A UUID that uniquely identifies a resource
      type: string
      pattern: '[a-z0-9]*'
      minLength: 1
      maxLength: 42
  securitySchemes:
    ApiKey:
      type: apiKey
      name: Api-Key
      in: header

````