IFSC Validation API

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.

Get Free Trial

Create a free account Or “Talk to Us” for price information and other queries.

API Details

Request

TypeURL
Posthttps://api.attestr.com/api/{version}/public/finanx/ifsc

Request Body Parameters

TypeNameDescriptionOptional (Default)Min VersionMax Version
StringifscIFSC code to be searchedRequiredv1

Request Header Parameters

TypeNameValue / DescriptionOptional (Default)Min VersionMax Version
StringContent-Typeapplication/jsonRequiredv1
StringAuthorizationBasic {authToken}Requiredv1

If you do not have the authentication token, please refer to Register App to generate one.

Sample Request

JSON
Copy

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.

KeyDescriptionTypeMin VersionMax Version
validTrue | false if the provided IFSC is validBooleanv1
bankName of the bankStringv1
codeBank codeStringv1
ifscIFSC code assigned to the branchStringv1
micrMICR code assigned to the branchStringv1
branchName of the bank branchStringv1
addressBranch complete addressStringv1
districtDistrict location of the branchStringv1
cityCity location of the branchStringv1
stateState location of the branchStringv1
neftTrue | false if NEFT payment mode is supportedBooleanv1
impsTrue | false if IPMS payment mode is supportedBooleanv1
rtgsTrue | false if RTGS payment mode is supportedBooleanv1
messageMessage string if IFSC is invalid (available only if valid is false)Stringv1
suggestionSuggested 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.Stringv1

Sample Response

Sample response for valid IFSC code

JSON
Copy

Sample response for invalid IFSC code

JSON
Copy

Error Response

ParameterTypeDescription
codeNumberUnique error codes for different errors. Always available.
messageStringError message describing the error. Always Available.
detailsStringDetail error message. Available only for certain types of errors.

Error Codes

HTTP StatusError CodeError Message
4004001Malformed data or missing required parameter values
4004005Operation could not be performed due to low credits balance
4014016Invalid client authorization
4034031Unauthorized access
4034035Requested service is not provisioned for your account
4034039Client's IP address is not whitelisted
4034035Requested service is not provisioned for your account
4294291Maximum account rate limit exceeded
4294292Maximum API rate limit exceeded
4294293Maximum account daily limit exceeded
4294294Maximum API daily limit exceeded
5005001Request could not be processed

Sample Error Response

JSON
Copy

Get Free Trial

Create a free account Or “Talk to Us” for price information and other queries.

Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard