🏦 IFSC API for Developers

Free REST API to lookup Indian bank IFSC codes, bank branches, and more. No API key required!

✓ 100% Free • No Rate Limits • Open for All
🆓

Completely Free

No API keys, no registration, no hidden costs

⚡

Fast & Reliable

Low latency responses with 99.9% uptime

🔓

CORS Enabled

Use directly from browser, no backend needed

📖 API Endpoints

🧪 Try It Now

🌐 Base URL

https://oksurya.com/ifsc-code/api/v1

1. IFSC Code Lookup

GET /api/v1/ifsc/{code}

Get complete bank branch details by IFSC code.

curl https://oksurya.com/ifsc-code/api/v1/ifsc/SBIN0000001

Response:

{
  "success": true,
  "data": {
    "ifsc": "SBIN0000001",
    "bank": "State Bank of India",
    "branch": "Main Branch",
    "address": "123 Main Street",
    "city": "Mumbai",
    "district": "Mumbai",
    "state": "Maharashtra",
    "contact": "022-12345678",
    "micr": "400002001",
    "swift": "SBININBB"
  }
}

2. List All Banks

GET /api/v1/banks

Get a list of all banks in India.

curl https://oksurya.com/ifsc-code/api/v1/banks

Response:

{
  "success": true,
  "data": {
    "total": 150,
    "banks": [
      { "name": "Axis Bank", "slug": "axis-bank" },
      { "name": "HDFC Bank", "slug": "hdfc-bank" },
      ...
    ]
  }
}

3. Bank Branches

GET /api/v1/banks/{slug}/branches

Get all branches of a specific bank.

Parameter Type Description
slug required string Bank slug (e.g., "state-bank-of-india")
limit integer Max results (default: 100, max: 500) 
curl "https://oksurya.com/ifsc-code/api/v1/banks/state-bank-of-india/branches?limit=50"

4. List All States

GET /api/v1/states

Get a list of all Indian states and union territories.

curl https://oksurya.com/ifsc-code/api/v1/states

5. State Districts

GET /api/v1/states/{slug}/districts

Get all districts in a specific state.

curl https://oksurya.com/ifsc-code/api/v1/states/maharashtra/districts

6. District Branches

GET /api/v1/districts/{slug}/branches

Get all bank branches in a specific district.

curl "https://oksurya.com/ifsc-code/api/v1/districts/mumbai/branches?limit=100"
GET /api/v1/search?q={query}

Search for branches by IFSC code, bank name, or branch name.

Parameter Type Description
q required string Search query (min 2 characters) 
curl "https://oksurya.com/ifsc-code/api/v1/search?q=sbi%20mumbai"

Response:

{
  "success": true,
  "data": {
    "query": "sbi mumbai",
    "total": 20,
    "results": [
      {
        "ifsc": "SBIN0000001",
        "bank": "State Bank of India",
        "branch": "Main Branch",
        "district": "Mumbai",
        "state": "Maharashtra"
      },
      ...
    ]
  }
}

❌ Error Responses

All errors follow a consistent format:

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "IFSC code not found"
  }
}
HTTP Code Error Code Description
400 INVALID_IFSC Invalid IFSC code format
400 INVALID_QUERY Search query too short
404 NOT_FOUND Resource not found
405 METHOD_NOT_ALLOWED Only GET requests allowed

💬 Support

Have questions or found a bug? Contact us or open an issue on our repository.