Run Account Name Enquiry

Validate a recipient account and return the account name for supported bank transfer and mobile money payout rails.

Endpoint

POST /api/v1/banking/name-enquiry

Send

Authorization
BearerAuth
AuthorizationBearer <token> in: header

Request Body

Content-Type: application/json

Fields

• account_number string
• bank_code string
• currency string

Response Body

Status Codes:

• 200 application/json
• 400 application/json
• 401 application/json
• 403 application/json
• 422 application/json
• 500 application/json
• 503 application/json

Example Request

curl -X POST "https://atlas.tryduplo.com/api/v1/banking/name-enquiry" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "account_number": "1234567890",
    "bank_code": "000000",
    "currency": "NGN"
  }'

Example Responses

200 Response

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Account name enquiry completed.",
  "statusCode": 200,
  "data": {
    "accountName": "John Doe",
    "bankCode": ""
  }
}

400 Response

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Name enquiry failed.",
  "statusCode": 400
}

401 Response

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Invalid API key.",
  "statusCode": 401
}

403 Response

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Incorrect PIN or access denied.",
  "statusCode": 403
}

422 Response

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "The given data was invalid.",
  "errors": {
    "account_number": [
      "The account number must be valid."
    ],
    "account_id": [
      "The account id must be valid."
    ]
  },
  "statusCode": 422
}

500 Response

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "An error occurred while processing your request.",
  "statusCode": 500
}

503 Response

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Banking service is temporarily unavailable.",
  "statusCode": 503
}

How is this guide?

Good / Bad

Last updated on 5/27/2026