Get Associated Bank Account

This endpoint accepts the following parameters in the request body: type (mobile_number or bvn). If type is mobile_number, the mobile_number field is required else if type is bvn, bvn is required.

The Radar (mobile_number) endpoint covers all Nigerian bank accounts that aligns with the NUBAN scheme, beside GTBank & UBA.

POST: https://api.creditchek.africa/v1/radar/get-banks

Request Parameters

Name	Position	Required	Description
token	Authorization	True	app public key
type	body	True	queried parameter e.g mobile_number or bvn
mobile_number	body	False	user phone number (required when type is mobile_number)
bvn	body	False	user bvn (required when type is bvn)
name	body	True	name of the user

Example Request

---
curl --location --request POST 'https://api.creditchek.africa/v1/radar/get-banks' \
--data-raw '{
    "type": "mobile_number",
    "mobile_number": "09070822819",
    "name": "John Doe"
}'
--data-raw '{
    "type": "bvn",
    "bvn": "09070822819",
    "name": "John Doe"
}'
---

Response

{
  "success": true,
  "message": "success",
  "data": {
    "name": "John Doe",
    "mobile_number": "0702****412",
    "type": "Phone No",
    "banks": [
      {
        "accountDescription": "005****261",
        "bankName": "Access Bank Nigeria Plc",
        "bankCode": "044",
        "mobile_number": "07026816412"
      },
      {
        "accountDescription": "138****765",
        "bankName": "Access Bank Nigeria Plc",
        "bankCode": "044",
        "mobile_number": "07026816412"
      }
    ],
  }
}