Request Message description
HTTP Method: GET
Endpoint: http://sandbox.interswitchng.com/api/v1/nameenquiry/banks/accounts/names
Headers:
Content Type:application/json
Authorization:InterswitchAuth SUifhfjdbxbkfhj132hdfhjshfjhsv
Signature:kuTwggg/3gdgdghs=
Timestamp: 1434455667788
Nonce:7333394444423754333
SignatureMethod:SHA1
bankCode: bankCode
accountId: accountNo
| Field # | Field name | Data type | Max length | Required | Description |
| 1 | bankCode | String | 3 | Yes | BANK CBN Code.
Click here for bank codes |
| 2 | accountId | String | 10 | Yes | Account to validate |
Click here to learn how to compute the other headers which will be required for authentication.
Response Message Fields
| Field # | Field name | Data type | Max length | Required | Description |
| 1 | accountName | String | 100 | Yes | Customers full name |
Response Code description
| Field # | Field name | Description |
| 1 | HTTP 200 | Success |
| 2 | HTTP 500 | Error |
| 3 | HTTP 400 | Request Payload is invalid |
Sample Response (success)
{
“accountName”: “Nnamdi Olakunle”
}
Sample Response (failure)
{
“errors”=>[
{
“code”=>”E38”,
“message”=>”Request payload is invalid”}
],
“error”=>
{
“code”=>”E38”,
“message”=>”Request payload is invalid”
}
}