IFSC Lookup

Retrieve detailed bank branch information using an IFSC (Indian Financial System Code), including bank name, branch address, supported payment channels (IMPS, RTGS, NEFT, UPI), and MICR code.

Endpoint

GET /vas-api/v1/ifsc-details

Authentication

Requires OAuth2 Bearer token. Get your credentials →

Request

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer YOUR_ACCESS_TOKEN

Query parameters

Parameter	Type	Required	Description	Example
ifscCode	string	Yes	11-character IFSC code (4 alpha + 0 + 6 alphanumeric)	SBIN0001234

Example request

curl

curl -X GET "https://api.api4business.com/vas-api/v1/ifsc-details?ifscCode=SBIN0001234" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Python

import requests

response = requests.get(
  "https://api.api4business.com/vas-api/v1/ifsc-details",
  params={"ifscCode": "SBIN0001234"},
  headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
)
print(response.json())

Node.js

const response = await fetch(
  "https://api.api4business.com/vas-api/v1/ifsc-details?ifscCode=SBIN0001234",
  { headers: { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } }
);
console.log(await response.json());

Java

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.api4business.com/vas-api/v1/ifsc-details?ifscCode=SBIN0001234"))
  .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
  .GET()
  .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

Success (200)

Field	Type	Description
ok	boolean	true if the request was successful
message	string	Status message (Transmission OK)
body.ifsc	string	The IFSC code queried
body.bankName	string	Full name of the bank
body.branch	string	Branch name
body.centre	string	Centre / circle the branch belongs to
body.city	string	City of the branch
body.district	string	District name
body.state	string	State name
body.address	string	Full postal address of the branch
body.contact	string	Branch contact number (may be 0 if unavailable)
body.micr	string	MICR (Magnetic Ink Character Recognition) code
body.iso3166	string	ISO 3166-2 state code (e.g., IN-MH for Maharashtra)
body.id	number	Internal record identifier
body.lastSynced	null	Last sync timestamp (null if not tracked)

Example response

{
  "ok": true,
  "message": "Transmission OK",
  "body": {
    "ifsc": "SBIN0001234",
    "bankName": "State Bank of India",
    "branch": "MUMBAI MAIN BRANCH",
    "centre": "MUMBAI",
    "city": "MUMBAI",
    "district": "MUMBAI",
    "state": "MAHARASHTRA",
    "address": "Fort, Mumbai, Maharashtra 400001",
    "contact": "02222740300",
    "micr": "400002001",
    "iso3166": "IN-MH",
    "id": 156321,
    "lastSynced": null
  }
}

Response headers

Header	Description
x-request-id	Unique request identifier — log this for debugging and support

Error responses

Status	Error Code	Message	Resolution
400	400	Invalid Request	Verify the ifscCode query parameter is present and 11 characters
400	400	Invalid IFSC	IFSC format is wrong — must be 4 letters + 0 + 6 alphanumeric
401	401	Invalid Credentials	Access token expired or invalid — request a new one
429	429	Quota Violation	Rate limit exceeded — retry with exponential backoff
500	500	Internal Server Error	Retry after 1-5 seconds
503	503	Service Not Available	Upstream service down — retry with backoff

Related

• Account Verification (Penny Drop) — Verify an account at this branch
• Account Verification (Penny-less) — Verify without deposit
• Bank Verification Overview
• Error Handling Guide