Skip to content

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 ​

HeaderTypeRequiredDescription
AuthorizationstringYesBearer YOUR_ACCESS_TOKEN

Query parameters ​

ParameterTypeRequiredDescriptionExample
ifscCodestringYes11-character IFSC code (4 alpha + 0 + 6 alphanumeric)SBIN0001234

Example request ​

bash
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())
javascript
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) ​

FieldTypeDescription
okbooleantrue if the request was successful
messagestringStatus message (Transmission OK)
body.ifscstringThe IFSC code queried
body.bankNamestringFull name of the bank
body.branchstringBranch name
body.centrestringCentre / circle the branch belongs to
body.citystringCity of the branch
body.districtstringDistrict name
body.statestringState name
body.addressstringFull postal address of the branch
body.contactstringBranch contact number (may be 0 if unavailable)
body.micrstringMICR (Magnetic Ink Character Recognition) code
body.iso3166stringISO 3166-2 state code (e.g., IN-MH for Maharashtra)
body.idnumberInternal record identifier
body.lastSyncednullLast sync timestamp (null if not tracked)

Example response ​

json
{
  "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 ​

HeaderDescription
x-request-idUnique request identifier — log this for debugging and support

Error responses ​

StatusError CodeMessageResolution
400400Invalid RequestVerify the ifscCode query parameter is present and 11 characters
400400Invalid IFSCIFSC format is wrong — must be 4 letters + 0 + 6 alphanumeric
401401Invalid CredentialsAccess token expired or invalid — request a new one
429429Quota ViolationRate limit exceeded — retry with exponential backoff
500500Internal Server ErrorRetry after 1-5 seconds
503503Service Not AvailableUpstream service down — retry with backoff

Released under the API4Business Terms of Service