Validate Account Number

Verify a recipient’s bank account before initiating a transfer. This confirms the account exists and returns the account holder’s name so you can confirm with your user before sending money.

Endpoint

POST /api/v1/business/validate

Signature required: Yes

Headers

Header	Required	Description
`X-Numero-Api-Key`	Yes	Your API key
`X-Numero-Signature`	Yes	Base64 HMAC-SHA256 over the exact raw request body (POST) or the canonicalised query string (GET), keyed with your Public Key. See Request signing.
`X-Numero-Signature-Version`	Yes	Always `v2`.

Request body

Field	Type	Required	Description
`accountNumber`	string	Yes	Recipient’s bank account number
`bankCode`	string	Yes	Recipient’s bank code (from Get Bank List)

Request example

curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/validate" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -d '{
    "accountNumber": "0123456789",
    "bankCode": "000013"
  }'

Response

{
  "data": {
    "accountName": "John Doe",
    "accountNumber": "0123456789",
    "bankCode": "000013"
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}

Field	Type	Description
`accountName`	string	The name on the bank account
`accountNumber`	string	The validated account number
`bankCode`	string	The bank code

Getting Started

Transfers & Payouts

Collections (Virtual Accounts)

Wallet-as-a-Service

Customers

Invoices

Cards

Cardholders

Balance & Transactions

Value Added Services

Credit

Verification / KYC

Webhooks

Validate Account Number

Endpoint

Headers

Request body

Request example

Response

​Endpoint

​Headers

​Request body

​Request example

​Response

Endpoint

Headers

Request body

Request example

Response