Skip to main content
POST
https://api-staging.fossapay.com
/
v1
/
transfers
/
fiat
/
bank-name-enquiry
Bank Name Enquiry
curl --request POST \
  --url https://api-staging.fossapay.com/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"
  }
}

​
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-staging.fossapay.com/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 enquiry = await client.fiatTransfers.bankNameEnquiry({
  bankCode: '00014',
  accountNumber: '1232129310'
});

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