FIND BANK AND BRANCH DETAILS FROM A GIVEN IFSC CODE
Description
Indian Financial System Code (IFSC) is a unique code assigned to each bank branch and used for online money transfers. This API is a reverse lookup to search bank and branch details for a given IFSC code.
API Outcome
- General bank information Name of the bank, bank code, branch IFSC code, branch MICR code
- Branch location Name of branch, address, city, district and state
- Supported transfer modes NEFT, IMPS, RTGS
- Suggestions Suggested new IFSC codes after recent bank acquisitions and mergers.
API Details
Request
| Type | URL |
|---|---|
| Post | https://api.attestr.com/api/{version}/public/finanx/ifsc |
Request Body Parameters
| Type | Name | Description | Optional (Default) | Min Version | Max Version |
|---|---|---|---|---|---|
| String | ifsc | IFSC code to be searched | Required | v1 |
Request Header Parameters
| Type | Name | Value / Description | Optional (Default) | Min Version | Max Version |
|---|---|---|---|---|---|
| String | Content-Type | application/json | Required | v1 | |
| String | Authorization | Basic {authToken} | Required | v1 |
If you do not have the authentication token, please refer to Register App to generate one.
Sample Request
{ "ifsc":"HDFC0000314"}Response
Http Status Code 200
Please note that the valid key decides the availability of rest of the keys in the response. If provided IFSC is invalid, then all keys except valid and message are omitted. If true, remaining keys will have appropriate data.
| Key | Description | Type | Min Version | Max Version |
|---|---|---|---|---|
| valid | True | false if the provided IFSC is valid | Boolean | v1 | |
| bank | Name of the bank | String | v1 | |
| code | Bank code | String | v1 | |
| ifsc | IFSC code assigned to the branch | String | v1 | |
| micr | MICR code assigned to the branch | String | v1 | |
| branch | Name of the bank branch | String | v1 | |
| address | Branch complete address | String | v1 | |
| district | District location of the branch | String | v1 | |
| city | City location of the branch | String | v1 | |
| state | State location of the branch | String | v1 | |
| neft | True | false if NEFT payment mode is supported | Boolean | v1 | |
| imps | True | false if IPMS payment mode is supported | Boolean | v1 | |
| rtgs | True | false if RTGS payment mode is supported | Boolean | v1 | |
| message | Message string if IFSC is invalid (available only if valid is false) | String | v1 | |
| suggestion | Suggested new IFSC codes after recent bank acquisitions and mergers. This is available if provided IFSC is invalid and there is a matching new IFSC code record in our database. | String | v1 |
Sample Response
Sample response for valid IFSC code
{ "valid": true, "bank": "HDFC Bank", "code": "HDFC", "ifsc": "HDFC0000314", "micr": "110240043", "branch": "NEW DELHI - DARYA GANJ", "city": "DELHI", "district": "NEW DELHI", "state": "DELHI", "address": "4686-92 , 21-AANSARI ROAD,DARYAGANJNEW DELHINEW DELHI110002", "neft": true, "imps": true, "rtgs": true}Sample response for invalid IFSC code
{ "valid": false, "message": "Invalid IFSC code", "suggestion": "ABCD2034252"}Error Response
| Parameter | Type | Description |
|---|---|---|
| code | Number | Unique error codes for different errors. Always available. |
| message | String | Error message describing the error. Always Available. |
| details | String | Detail error message. Available only for certain types of errors. |
Error Codes
| HTTP Status | Error Code | Error Message |
|---|---|---|
| 400 | 4001 | Malformed data or missing required parameter values |
| 400 | 4005 | Operation could not be performed due to low credits balance |
| 401 | 4016 | Invalid client authorization |
| 403 | 4031 | Unauthorized access |
| 403 | 4035 | Requested service is not provisioned for your account |
| 403 | 4039 | Client's IP address is not whitelisted |
| 403 | 4035 | Requested service is not provisioned for your account |
| 429 | 4291 | Maximum account rate limit exceeded |
| 429 | 4292 | Maximum API rate limit exceeded |
| 429 | 4293 | Maximum account daily limit exceeded |
| 429 | 4294 | Maximum API daily limit exceeded |
| 500 | 5001 | Request could not be processed |
Sample Error Response
{ "code": 4001, "message": "Malformed data or missing required parameter values"}