Account Lookup

GET

/bank/{bank_slug}/account/lookup/

Last modified:2023-05-13 09:17:47

This page returns the customer account and the customer name giving the customer ID or account number.

The endpoints takes the bank slug and the account_number as query string and returns the client name and his formatted account number.
The account_number query parameter accepts the customer account number, the email or the phone number.

Note that this endpoint is used only for banks that accepts lookup function.
To know that bank accepts lookup, please check the has_lookup variable in the api_values attribute in every bank body.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://127.0.0.1:8081/api/v2/bank/MF1-0001/account/lookup/?account_number=16-01' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

Body

Example

{
    "response_code": "00",
    "response_data": {
        "account_number": "30001-01-00-0000000001-01-95",
        "name": "Bizimana Jean Claude"
    },
    "response_message": "Success",
    "success": true
}

Modified at 2023-05-13 09:17:47

Cashout Payment banks

Bills operations flow