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

# Validate Recipient Account

> Validates bank account details before beneficiary creation.

This endpoint validates the recipient bank account details with the destination bank or provider. It is a critical step in the Bank Transfer flow to ensure funds are sent to the correct account.

## Request Body

<ParamField body="bankCode" type="string" required>
  The unique code of the bank (retrieved from `list-supported-banks`).
</ParamField>

<ParamField body="transactionType" type="string" required default="ACCOUNTPAYMENT">
  The transaction type. Use `ACCOUNTPAYMENT` for bank transfers.
</ParamField>

<ParamField body="accountNumber" type="string" required>
  The account number to validate.
</ParamField>

<ParamField body="accountNumberCountry" type="string" required>
  ISO 3166-1 alpha-3 country code of the account (e.g., `NGA`).
</ParamField>

<ParamField body="expectedCurrencyCode" type="string" required>
  The currency of the account (e.g., `NGN`).
</ParamField>

## Code Example

```bash cURL theme={null}
curl -X GET 'https://remitjunction.fincode.software/api/v6/services/usermanagement/validate-bank-account' \
--header 'X-Auth-Token: YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "bankCode": "214",
    "transactionType": "ACCOUNTPAYMENT",
    "accountNumber": "8883968718",
    "accountNumberCountry": "NGA",
    "expectedCurrencyCode": "NGN"
}'
```


## OpenAPI

````yaml GET /usermanagement/validate-bank-account
openapi: 3.0.0
info:
  title: FinCode API
  version: v6
servers:
  - url: https://{tenant}.fincode.software/api/v6/services
    description: API v6
    variables:
      tenant:
        default: remitjunction
        description: Enter your tenant subdomain
  - url: https://{tenant}.fincode.software/api/v1/services
    description: API v1
    variables:
      tenant:
        default: finlend
        description: Enter your tenant subdomain
  - url: https://api.stag.songhaiexchange.io
    description: Songhai Exchange API
security: []
paths:
  /usermanagement/validate-bank-account:
    get:
      summary: Validate Bank Account
      description: Validates bank account details
      operationId: validateBankAccount
      parameters:
        - $ref: '#/components/parameters/platformHeader'
        - $ref: '#/components/parameters/uuidHeader'
        - in: header
          name: X-Auth-Token
          schema:
            type: string
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                bankCode:
                  type: string
                transactionType:
                  type: string
                  default: ACCOUNTPAYMENT
                accountNumber:
                  type: string
                accountNumberCountry:
                  type: string
                expectedCurrencyCode:
                  type: string
              required:
                - bankCode
                - transactionType
                - accountNumber
                - accountNumberCountry
                - expectedCurrencyCode
      responses:
        '200':
          description: Validation result
components:
  parameters:
    platformHeader:
      in: header
      name: platform
      schema:
        type: string
        default: fincode
      required: true
    uuidHeader:
      in: header
      name: uuid
      schema:
        type: string
        default: '200'
      required: true

````