Account Enquiry

Use the Account Enquiry endpoint to confirm the account name associated with a bank account number and sort code before sending a payout. This helps prevent failed transfers and misdirected funds.

When to use it

Before every payout — validate that the destination account name matches your intended recipient.
During onboarding — confirm a customer’s bank details when saving them for later use.
Fraud checks — detect mismatches between user-submitted details and the bank’s records.

Required details

You must provide:

Field	Description	Example
`currency`	Currency of the destination account	`NGN`
`country`	Two-letter country code	`NG`
`account.accountNumber`	Bank account number to enquire about	`0690000032`
`account.sortCode`	Bank sort code (bank code)	`044`

Example request

curl --request POST \
  --url https://sandboxapi.me-cash.com/v1/account/enquiry \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "currency": "NGN",
    "country": "NG",
    "account": {
      "accountNumber": "0690000032",
      "sortCode": "044"
    }
  }'

Example response

{
  "accountNumber": "0690000032",
  "accountName": "JOHN DOE",
  "bankName": "ACCESS BANK NIGERIA",
  "sortCode": "044",
  "currency": "NGN",
  "country": "NG"
}

Field reference

Request — `CreateAccountEnquiryRequest`

string

required

Currency code of the destination account (e.g. NGN).

string

required

Two-letter ISO country code (e.g. NG).

object

required

Object containing the bank account details to verify.

Show account properties

string

required

Bank account number to enquire about.

string

required

Bank sort code (bank code).

Response — `AccountEnquiry`

string

The account number that was queried. Example: 0690000032.

string

Registered name of the account holder. Example: JOHN DOE.

string

Name of the bank that owns the account. Example: ACCESS BANK NIGERIA.

string

Sort code of the bank. Example: 044.

string

Currency code of the account. Example: NGN.

string

Country code of the account. Example: NG.

Create Payout — send funds after verifying the account.
Bank List — retrieve supported banks and sort codes.

Overview

Wallets

Quotes

Payouts

Virtual Accounts

Ramp

Transactions

Webhooks

When to use it

Required details

Example request

Example response

Field reference

Request — `CreateAccountEnquiryRequest`

Response — `AccountEnquiry`

​When to use it

​Required details

​Example request

​Example response

​Field reference

​Request — CreateAccountEnquiryRequest

​Response — AccountEnquiry

​Related

When to use it

Required details

Example request

Example response

Field reference

Request — `CreateAccountEnquiryRequest`

Response — `AccountEnquiry`

Related