Nigeria Bank Account Verification

Verifies a Nigerian bank account using the provided bank code and account number. The endpoint resolves the account and returns the registered account name and bank details when the account is successfully verified.

Endpoint

POST {{base_url}}/api/v1/payout/bank-list/verify

Authentication

Important: Dedicated API Key Required

This endpoint uses a dedicated API key and does not use the regular LedgerBlock API key.

Use the following API key specifically for the Bank Account Verification endpoint:

cf002c2f7c9b7a3e3280cf5d77ab539467dc

Authentication	Required	Value
Bearer Token	Yes	`cf002c2f7c9b7a3e3280cf5d77ab539467dc`

Headers

Header	Required	Description
`x-merchant-ref`	Yes	Your unique merchant reference.
`Content-Type`	Yes	Must be set to `application/json`.

Request Body

{
  "bank_code": "090551",
  "account_number": "0316839265"
}

Request Fields

Field	Type	Required	Description
`bank_code`	String	Yes	Unique code identifying the Nigerian bank or financial institution.
`account_number`	String	Yes	Nigerian bank account number to be verified.

Example Request

curl --location -g '{{base_url}}/api/v1/payout/bank-list/verify' \
--header 'Authorization: Bearer {{bearer_token}}' \
--header 'x-merchant-ref: {{x-merchant-ref}}' \
--header 'Content-Type: application/json' \
--data '{
  "bank_code": "090551",
  "account_number": "0316839265"
}'

Response

`200 OK`

{
  "status": "success",
  "message": "Account resolved",
  "data": {
    "status_code": 200,
    "account_name": "James Harry",
    "bank_code": "090551",
    "bank_name": "First Bank"
  }
}

Response Fields

Field	Type	Description
`status`	String	Indicates whether the request was successful.
`message`	String	Response message.
`data`	Object	Contains the resolved bank account information.
`data.status_code`	Integer	Status code returned for the account verification.
`data.account_name`	String	Name registered to the bank account.
`data.bank_code`	String	Bank code associated with the account.
`data.bank_name`	String	Name of the bank or financial institution.

Updated 21 days ago

Did this page help you?