--- page_title: IFSC Validation product: Payout page_source: https://juspay.io/in/docs/payout/docs/integration/ifsc-validation openapi: https://juspay.io/in/docs/api/swagger?document=https%3A%2F%2Fjuspay.io%2Fin%2Fdocs%2Fpayout%2Fdocs%2Fintegration%2Fifsc-validation%3Fversion%3Dv1 llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/payout/llms.txt --- ## API Version: v1 # IFSC Validation Merchants can use this API to validate the IFSC provided by the user. The validation is based on data sourced from the official RBI repository, which is regularly updated and maintained by Juspay to ensure high accuracy and reliability.## Endpoints: - Sandbox: https://sandbox.juspay.in/payout/merchant/v1/ifsc/:ifsc - Production: https://api.juspay.in/payout/merchant/v1/ifsc/:ifsc ## Request Type: GET ## Authorization: #### Basic Auth: Consists of two parts. * Username: API Key obtained from Juspay dashboard * Password: Empty string Example:- Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg== - Tags: String, Mandatory ## Headers: #### x-merchantid: pass merchant id that is provided by Juspay - Tags: string ## Sample Code Snippets: ### Sample Request: #### Request Code Snippet: ```request curl --location --request GET 'https://api.juspay.in/payout/merchant/v1/ifsc/:ifsc' \ -u your_api_key: \ --header 'x-merchantid: ' ``` ### Sample Response: #### Response for VALID: ```json { "status": "VALID", "state": "KARNATAKA", "swift": "HDFCINBB", "contact": "+919945863333", "address": "NO.9, ETERNAKORAMANGLA INDUSTRIAL LAYOUTKORAMANGLABANGALOREKARNATAKA560095", "branch": "BANGALORE - KORAMANGALAM", "ifsc": "HDFC0000053", "city": "BANGALORE URBAN", "micr": "560240004", "bankCode": "HDFC", "centre": "BANGALORE", "district": "BANGALORE", "bankName": "HDFC Bank" } ``` #### Response for VALID - Sponsored IFSC: ```plaintext { "status": "VALID", "additionalInfo": { "sponsorBank": "Andhra Pradesh State Co-operative Bank" }, "state": "ANDHRA PRADESH", "subStatus": "SPONSORED", "contact": "+919160018917", "address": "MARKET JN JALUMURU MDL SRIKAKULAM 532432", "branch": "DISTCOOPBANKLTD SRKL CHALLAVANIPETA", "ifsc": "APBL0001015", "city": "KOTABOMMALI", "micr": "532852006", "bankCode": "TSDX", "centre": "SRIKAKULAM", "district": "SRIKAKULAM", "bankName": "District Co-operative Central Bank Srikakul" } ``` #### INVALID - Merged Bank with details: ```plaintext { "status": "INVALID", "additionalInfo": { "mergerDetails": { "state": "UTTAR PRADESH", "address": "17/254 17/255 CHILI INT ROAD AGRA GHATIYA AZAM KHAN PIN 282003", "branch": "AGRA CHILI INT ROAD", "ifsc": "IDIB000A524", "city": "AGRA", "district": "AGRA", "bank": "Indian Bank" } }, "subStatus": "MERGED", "message": "Merged Bank" } ``` #### INVALID - Merged Bank with no details available: ```plaintext { "status": "INVALID", "subStatus": "MERGED", "message": "Merged Bank" } ``` #### Invalid Format: ```plaintext { "status": "INVALID", "message": "IFSC code must be 11 characters: 4 letters, followed by 0, then 6 alphanumeric characters." } ``` #### IFSC Not found: ```plaintext { "status": "NOT_FOUND", "message": "Ifsc not found" } ``` ## Path Parameters: #### ifsc: pass ifsc that needs to be validated - Value: IFSC code must be 11 characters: 4 letters, followed by 0, then 6 alphanumeric characters. - Tags: String, Mandatory ## API Responses: ### 200: #### status: - Description: Status of the IFSC - Value: possible value : VALID | INVALID | NOT_FOUND - Tags: string, Mandatory #### subStatus: - Description: Substatus of the Ifsc - Value: Possible value : SPONSORED | MERGED | BLOCKED - Tags: String #### bankCode: - Description: Represents the bankCode of the bank - Tags: String #### bankName: - Description: Name of the bank - Tags: String #### branch: - Description: Branch name of the bank - Tags: String #### city: - Description: City of the bank operational address - Tags: String #### district: - Description: District of the city where the bank operates - Tags: String #### state: - Description: State of the city where the bank operates - Tags: String #### centre: - Description: Centre of the bank - Tags: String #### address: - Description: Address of the bank branch - Tags: String #### swift: - Description: Swift code of the bank branch - Tags: String #### micr: - Description: Micr of the bank branch - Tags: String #### contact: - Description: Contact information of the bank branch - Tags: String #### additionalInfo: - Description: Additional Information regarding the IFSC, if the IFSC passed in the request belongs to Sponsored bank or if the  subStatus is MERGED. - Value: - **SponsorBank**: - Description: Name of the Sponsor Bank - Tags: String - **MergerDetails**: - Description: Json that contains the details of the current valid IFSC - Value: - **Ifsc**: - Description: The new, valid IFSC that has replaced the merged/old IFSC. - Tags: String - **Bank**: - Description: Name of the bank associated with the current IFSC. - Tags: String - **Branch**: - Description: Name of the branch associated with the new IFSC. - Tags: String - **State**: - Description: The state where the new IFSC branch is located. - Tags: String - **District**: - Description: The district of the new IFSC branch. - Tags: String - **City**: - Description: The city of the new IFSC branch. - Tags: String - **Address**: - Description: Address of the new branch location. - Tags: String - Tags: JSON - Tags: JSON #### message: - Description: Message of the API Request - Value: Possible values - "Ifsc not found","Merged Bank", "Blocked Bank", "IFSC code must be 11 characters: 4 letters, followed by 0, then 6 alphanumeric characters." - Tags: String #### ifsc: - Description: IFSC of the bank - Tags: String ### 401: #### error: - Value: Example:- true - Tags: Boolean #### errorCode: - Value: Example:- E07 - Tags: String #### errorMessage: - Value: Example:- Invalid API key passed in request. - Tags: String #### userMessage: - Value: Example:- Invalid API key - Tags: String --- ## See Also - [Cancel API](https://juspay.io/in/docs/payout/docs/integration/cancel-api) - [List of Error Codes](https://juspay.io/in/docs/payout/docs/resources/list-of-error-codes)