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

Authorization

BearerAuth

Authorization: Bearer <token>

Request Body

{
  "account_number": "string",
  "bank_code": "string",
  "currency": "string"
}

Response Body

200 - application/json

{
  "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 - application/json

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

401 - application/json

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

403 - application/json

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

422 - application/json

{
  "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 - application/json

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

503 - application/json

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

Example cURL Request

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

Feedback

How is this guide?

Good, Bad

Last updated on 5/27/2026