Skip to main content
POST
/
api
/
v1
/
transfers
/
fiat
/
bank-name-enquiry
Bank Name Enquiry
curl --request POST \
  --url https://api-production.fossapay.com/api/v1/transfers/fiat/bank-name-enquiry \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "bankCode": "<string>",
  "accountNumber": "<string>"
}
'
{
  "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"
  }
}

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.

​
Request

​
x-api-key
string
required
API Key for authentication
​
bankCode
string
required
The bank code for the account enquiry
​
accountNumber
string
required
The account number to enquire about

​
Request Example

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"
  }'

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

{
  "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"
  }
}

{
  "status": false,
  "statusCode": 400,
  "message": "Bad request",
  "error": "Invalid bank code or account number"
}

{
  "status": false,
  "statusCode": 500,
  "message": "Internal server error",
  "error": "Bank name enquiry failed"
}