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

# Validate bank account

> Validates an account number against a bank code and returns the resolved account details.



## OpenAPI

````yaml /openapi/miscellaneous.openapi.json post /utility/bank/validate
openapi: 3.0.3
info:
  title: Miscellaneous API
  version: 1.0.0
  description: OpenAPI spec for mock webhook payload testing.
servers:
  - url: https://staging-api.yourflexpay.com/v2
    description: Staging
  - url: https://sandbox-api.yourflexpay.com/v2
    description: Sandbox
  - url: https://api.yourflexpay.com/v2
    description: Live
security: []
tags:
  - name: Mock Webhook
  - name: Banking Utility
paths:
  /utility/bank/validate:
    post:
      tags:
        - Banking Utility
      summary: Validate bank account
      description: >-
        Validates an account number against a bank code and returns the resolved
        account details.
      parameters:
        - name: provider
          in: query
          required: false
          schema:
            type: string
          description: Optional account validation provider.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BankAccountLookupDto'
            example:
              accountNumber: '1100123765'
              bankCode: '090267'
      responses:
        '200':
          description: Validated account details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidatedBankAccount'
              examples:
                default:
                  summary: Resolved account profile
                  value:
                    AccountName: ADEDAYO MATTHEWS
                    AccountNumber: '1100123765'
                    BankName: KUDA MICROFINANCE BANK
                    BankCode: '090267'
components:
  schemas:
    BankAccountLookupDto:
      type: object
      required:
        - accountNumber
        - bankCode
      properties:
        accountNumber:
          type: string
        bankCode:
          type: string
    ValidatedBankAccount:
      type: object
      required:
        - AccountName
        - AccountNumber
        - BankName
        - BankCode
      properties:
        AccountName:
          type: string
        AccountNumber:
          type: string
        BankName:
          type: string
        BankCode:
          type: string

````