> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fossapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bank Name Enquiry

> Perform bank account name enquiry

## Request

<ParamField header="x-api-key" type="string" required>
  API Key for authentication
</ParamField>

<ParamField body="bankCode" type="string" required>
  The bank code for the account enquiry
</ParamField>

<ParamField body="accountNumber" type="string" required>
  The account number to enquire about
</ParamField>

### Request Example

```bash theme={null}
curl -X POST https://api-production.fossapay.com/api/v1/transfers/fiat/bank-name-enquiry \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "bankCode": "00014",
    "accountNumber": "1232129310"
  }'
```

```javascript theme={null}
const response = await fetch('https://api-production.fossapay.com/api/v1/transfers/fiat/bank-name-enquiry', {
  method: 'POST',
  headers: {
    'x-api-key': 'your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    bankCode: '00014',
    accountNumber: '1232129310'
  })
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const enquiry = await response.json();
```

## Response

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": true,
    "statusCode": 201,
    "message": "Bank name enquiry completed successfully",
    "data": {
      "sessionID": "000003677112224942366991412665",
      "destinationInstitutionCode": "00014",
      "channelCode": 2,
      "accountNumber": "1232129310",
      "accountName": "JANE ELIM DOE",
      "kycLevel": "3",
      "responseCode": "00"
    }
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json Error Response (400) theme={null}
  {
    "status": false,
    "statusCode": 400,
    "message": "Bad request",
    "error": "Invalid bank code or account number"
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json Error Response (500) theme={null}
  {
    "status": false,
    "statusCode": 500,
    "message": "Internal server error",
    "error": "Bank name enquiry failed"
  }
  ```
</ResponseExample>