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

# Validate Account

> Resolve an account number to an account name before initiating transfer

Resolve an account number to an account name before initiating transfer.

## Endpoint

<Badge variant="success">**POST**</Badge> `/pms/api/external/request/wallet/validate-account/`

## Request Body

**Media type:** `application/json`

```json theme={null}
{
  "account_number": "4044823317",
  "bank_code": "8980"
}
```

<ParamField body="account_number" type="string" required>
  Bank account number to validate
</ParamField>

<ParamField body="bank_code" type="string" required>
  Bank code for the destination bank
</ParamField>

## Response

### 200

**Media type:** `application/json`

```json theme={null}
{
  "status": true,
  "message": "string",
  "data": {
    "account_name": "string",
    "account_number": "string",
    "bank_code": "string",
    "bank_name": "string"
  }
}
```

## Response Fields

<ResponseField name="status" type="boolean">
  Request status indicator
</ResponseField>

<ResponseField name="message" type="string">
  Response message
</ResponseField>

<ResponseField name="data" type="object">
  Validated account details
</ResponseField>

<ResponseField name="data.account_name" type="string">
  Resolved account holder name
</ResponseField>

<ResponseField name="data.account_number" type="string">
  Account number that was validated
</ResponseField>

<ResponseField name="data.bank_code" type="string">
  Bank code used for validation
</ResponseField>

<ResponseField name="data.bank_name" type="string">
  Resolved bank name
</ResponseField>


## OpenAPI

````yaml POST /pms/api/external/request/wallet/validate-account/
openapi: 3.1.0
info:
  title: PayVessel API
  description: >-
    PayVessel API for accepting payments, sending money, verifying identities,
    and managing wallets
  version: 1.0.0
servers:
  - url: https://api.payvessel.com
  - url: https://sandbox.payvessel.com
security:
  - {}
paths:
  /pms/api/external/request/wallet/validate-account/:
    post:
      tags:
        - Transfers
      summary: Validate Account
      description: Resolve an account number to an account name before initiating transfer
      parameters:
        - name: api-key
          in: header
          description: Your Payvessel public API key
          required: true
          schema:
            type: string
        - name: api-secret
          in: header
          description: Your Payvessel secret
          required: true
          schema:
            type: string
        - name: Content-Type
          in: header
          description: Request content type
          required: true
          schema:
            type: string
            enum:
              - application/json
          example: application/json
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ValidateAccountRequest'
            example:
              account_number: '4044823317'
              bank_code: '8980'
      responses:
        '200':
          description: Account validated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidateAccountResponse'
              example:
                status: true
                message: Account resolved successfully
                data:
                  account_name: John Doe
                  account_number: '4044823317'
                  bank_code: '8980'
                  bank_name: PayVessel MFB
components:
  schemas:
    ValidateAccountRequest:
      type: object
      required:
        - account_number
        - bank_code
      properties:
        account_number:
          type: string
          description: Bank account number to validate
        bank_code:
          type: string
          description: Bank code for the destination bank
    ValidateAccountResponse:
      type: object
      properties:
        status:
          type: boolean
          description: Request status indicator
        message:
          type: string
          description: Response message
        data:
          type: object
          properties:
            account_name:
              type: string
              description: Resolved account holder name
            account_number:
              type: string
              description: Account number that was validated
            bank_code:
              type: string
              description: Bank code used for validation
            bank_name:
              type: string
              description: Resolved bank name

````