# 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

```bash
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
```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 Response
```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Name enquiry failed.",
  "statusCode": 400
}
```

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

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

#### 422 Response
```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 Response
```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 Response
```json
{
  "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