Financial Verification

Verify bank accounts and run Anti-Money Laundering (AML) checks.

Bank Account Verification

Verify a bank account number and retrieve account holder details.

POST /api/v1/business/verification/bank-account

Signature required: Yes

Request body

Field	Type	Required	Description
`accountNumber`	string	Yes	Bank account number
`bankCode`	string	Yes	Bank code (from Get Bank List)
`idempotencyKey`	string	No	Unique key to prevent duplicate charges

Request example

curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/verification/bank-account" \
  -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"
  }'

AML Check

Run an Anti-Money Laundering screening against global watchlists.

POST /api/v1/business/verification/aml

Signature required: Yes

Request body

Field	Type	Required	Description
`fullName`	string	No	Full name (alternative to firstName + lastName)
`firstName`	string	No	First name
`lastName`	string	No	Last name
`dateOfBirth`	string	No	Date of birth (YYYY-MM-DD)
`yearOfBirth`	integer	No	4-digit year of birth
`countries`	string	Yes	ISO2 country codes, comma-separated (e.g., `"NG"` or `"NG,KE"`)
`phoneNumber`	string	No	Phone number
`address`	string	No	Address
`bvn`	string	No	BVN
`nin`	string	No	NIN
`additionalParams`	object	No	Additional key-value parameters
`idempotencyKey`	string	No	Unique key to prevent duplicate charges

Provide at least a name (fullName or firstName + lastName) and countries for the check to work.

Request example

curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/verification/aml" \
  -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 '{
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "1990-05-15",
    "countries": "NG"
  }'

Getting Started

Transfers & Payouts

Collections (Virtual Accounts)

Wallet-as-a-Service

Customers

Invoices

Cards

Cardholders

Balance & Transactions

Value Added Services

Credit

Verification / KYC

Webhooks

Financial Verification

Bank Account Verification

Request body

Request example

AML Check

Request body

Request example

​Bank Account Verification

​Request body

​Request example

​AML Check

​Request body

​Request example

Bank Account Verification

Request body

Request example

AML Check

Request body

Request example