---
name: india-api
description: Look up Indian reference data with the free India API (api.dharun.dev): pincodes and post offices, IFSC codes and bank branches, GSTIN and PAN format checks, bank, market and government holidays and working days, RTO vehicle codes, NSE and BSE company logos, mutual fund NAVs, HSN and SAC codes, UPI QR codes, numbers in words (lakh, crore), transliteration between Indian scripts, panchang and more. Use when building an app that needs Indian data, or when the user asks about an Indian pincode, IFSC, GSTIN, PAN, holiday, vehicle registration or listed company. No API key needed.
license: MIT-0
metadata:
  homepage: https://api.dharun.dev
  source: https://github.com/dharunashokkumar/api.dharun.dev
---

# India API

Free JSON APIs for Indian data at https://api.dharun.dev: pincodes, IFSC and bank branches, GSTIN and PAN format checks, holidays and working days, RTO codes, company logos, mutual fund NAVs, HSN codes, UPI QR codes, Indian number words and more. No API key, no sign-up, CORS open. Open source (https://github.com/dharunashokkumar/api.dharun.dev).

## When to use it

- The user is building something that needs Indian reference data: a form that fills city and state from a pincode, a payout flow that shows the bank branch for an IFSC, an invoice with the amount in words, GST onboarding, scheduling around bank or market holidays, a stock app with company logos.
- The user asks a question this data answers: which district a pincode is in, which branch an IFSC belongs to, whether a date is a bank holiday in a state, which RTO a number plate is from. Call the API instead of answering from memory: branches, holiday lists and NAVs change.

If an MCP server named `india-api` is connected (https://api.dharun.dev/mcp), its tools return the same data and can be used directly.

## How to call it

- Every endpoint is a GET under `https://api.dharun.dev/v1`. Endpoints that take text also accept a POST body as `text/plain` or JSON `{"text": "..."}`.
- Success: `{ "data": ..., "meta": { ... } }`. `data` is an object, or an array for searches and lists, which add `meta.total`, `meta.limit` and `meta.offset`.
- Failure: `{ "error": { "code": "...", "message": "..." } }` with the HTTP status: 400 bad input, 404 nothing found, 429 over the rate limit (wait a minute), 503 dataset not loaded yet (try later).
- Rate limit: 600 requests a minute per IP address; image rendering, astronomy and live network checks count as 10. Cache answers you reuse.
- Image endpoints (logos, QR codes, barcodes, social cards) return the image itself; put the URL in an `<img>` tag.

```js
const response = await fetch("https://api.dharun.dev/v1/pincode/637001");
const body = await response.json();
if (!response.ok) throw new Error(body.error.message);
const { district, state } = body.data;
```

```python
import requests

response = requests.get("https://api.dharun.dev/v1/ifsc/SBIN0000001", timeout=10)
body = response.json()
if not response.ok:
    raise RuntimeError(body["error"]["message"])
print(body["data"]["branch"], body["data"]["bank"]["name"])
```

## Rules

- `meta.source` names each dataset's licence and the credit line (`attribution`) it asks for. When an app shows the data to people, show that credit where the licence asks for one.
- Format checks (`/v1/validate/...`) confirm structure and check characters only, not that a GSTIN, PAN or IFSC was ever issued.
- Send no more personal data than the task needs. Endpoints that take personal values (phone, email, IP, text tools) never log their input.
- Company logos are trademarks of their owners.

## Endpoints

Each API's full parameters, enums and examples are in `references/<id>.md`.

### Money and business

**Company logos** ([references/logos.md](references/logos.md)): Logos and details for companies listed on NSE and BSE.

- `GET /v1/logos/{symbol}`: Logo image for a listed company. Example: `/v1/logos/TCS`
- `GET /v1/companies/{symbol}`: Details of a listed company. Example: `/v1/companies/RELIANCE`
- `GET /v1/companies`: Search listed companies. Example: `/v1/companies?q=tata&limit=5`

**IFSC and banks** ([references/ifsc.md](references/ifsc.md)): IFSC to bank and branch.

- `GET /v1/ifsc/{code}`: Branch for an IFSC. Example: `/v1/ifsc/SBIN0000001`
- `GET /v1/ifsc`: Search a bank's branches. Example: `/v1/ifsc?bank=SBIN&state=TN&q=namakkal`
- `GET /v1/banks/{code}`: Bank for a four-letter code. Example: `/v1/banks/HDFC`
- `GET /v1/banks`: Search banks. Example: `/v1/banks?q=gramin`

**QR codes and barcodes** ([references/codes.md](references/codes.md)): QR codes, UPI payment QR codes and barcodes as SVG or PNG.

- `GET /v1/qr`: QR code for any text. Example: `/v1/qr?text=https://api.dharun.dev&format=png&size=256`
- `GET /v1/upi-qr`: UPI payment QR code. Example: `/v1/upi-qr?pa=shop@okaxis&pn=Sri%20Murugan%20Stores&am=250&tn=Order%2042`
- `GET /v1/barcode/{type}`: Barcode. Example: `/v1/barcode/ean13?text=890123456789`

**HSN and SAC codes** ([references/hsn.md](references/hsn.md)): GST classification codes for goods and services.

- `GET /v1/hsn/{code}`: A code, its parents and children. Example: `/v1/hsn/0902`
- `GET /v1/hsn`: Search codes. Example: `/v1/hsn?q=green%20tea`

**Mutual fund NAVs** ([references/mutual-funds.md](references/mutual-funds.md)): Latest net asset value of every Indian mutual fund scheme.

- `GET /v1/mutual-funds/{code}`: A scheme and its NAV. Example: `/v1/mutual-funds/122639`
- `GET /v1/mutual-funds`: Search schemes. Example: `/v1/mutual-funds?q=flexi%20cap&plan=direct&option=growth`
- `GET /v1/mutual-funds/fund-houses`: Fund houses. Example: `/v1/mutual-funds/fund-houses`

**Number to words** ([references/words.md](references/words.md)): Numbers and rupee amounts in words, the Indian way.

- `GET /v1/words/{number}`: Spell out a number. Example: `/v1/words/1,25,000.50?style=currency`

**Format checks** ([references/validate.md](references/validate.md)): Check the format of a GSTIN, PAN or IFSC.

- `GET /v1/validate/{kind}/{value}`: Check an identifier's format. Example: `/v1/validate/gstin/27AAPFU0939F1ZV`

### Places and transport

**Pincodes** ([references/pincode.md](references/pincode.md)): Pincode to post office, district and state.

- `GET /v1/pincode/{pincode}`: Post offices for a pincode. Example: `/v1/pincode/637001`
- `GET /v1/pincode`: Search post offices. Example: `/v1/pincode?q=namakkal&state=TN`
- `GET /v1/pincode/near`: Post offices near a point. Example: `/v1/pincode/near?lat=11.2189&lng=78.1674&radius=5`

**RTO codes** ([references/rto.md](references/rto.md)): Vehicle registration code to transport office.

- `GET /v1/rto/{code}`: Office for an RTO code. Example: `/v1/rto/TN-28`
- `GET /v1/rto`: List or search RTO codes. Example: `/v1/rto?state=TN&q=chennai`

**Railway stations** ([references/stations.md](references/stations.md)): Indian Railways station codes to stations, and back.

- `GET /v1/stations/{code}`: Station for a code. Example: `/v1/stations/MAS`
- `GET /v1/stations`: Search stations. Example: `/v1/stations?q=chennai`
- `GET /v1/stations/zones`: Railway zones. Example: `/v1/stations/zones`

**Constituencies** ([references/constituency.md](references/constituency.md)): Which assembly and Lok Sabha constituency a place is in.

- `GET /v1/constituency`: Constituencies of a place. Example: `/v1/constituency?pincode=637001`

**Airports** ([references/airports.md](references/airports.md)): Airport codes to airports, and airports by city.

- `GET /v1/airports/{code}`: Airport for a code. Example: `/v1/airports/MAA`
- `GET /v1/airports`: Search airports. Example: `/v1/airports?q=chennai`

**States** ([references/states.md](references/states.md)): States and union territories with their codes.

- `GET /v1/states`: All states and union territories. Example: `/v1/states`
- `GET /v1/states/{code}`: One state. Example: `/v1/states/TN`

### Dates and calendars

**Holidays** ([references/holidays.md](references/holidays.md)): Bank, government and stock market holidays.

- `GET /v1/holidays/{year}`: Holidays in a year. Example: `/v1/holidays/2026?type=market`

**Working days** ([references/working-days.md](references/working-days.md)): Bank, market, settlement and government working days.

- `GET /v1/working-days/{date}`: Is a date a working day. Example: `/v1/working-days/2026-01-16?calendar=bank&state=TN&add=3`
- `GET /v1/working-days`: Count working days between two dates. Example: `/v1/working-days?from=2026-01-01&to=2026-01-31&calendar=market`
- `GET /v1/market/status`: Is the stock market open. Example: `/v1/market/status?at=2026-01-26T10:00:00%2B05:30`

**Panchang** ([references/panchang.md](references/panchang.md)): Hindu almanac for any date and place: tithi, nakshatra, Rahu kalam and more.

- `GET /v1/panchang/{date}`: Panchang for a date. Example: `/v1/panchang/2026-01-14?pincode=600001`

**Sun and moon** ([references/sun-moon.md](references/sun-moon.md)): Sunrise, sunset, twilight, moonrise and the moon's phase for any date and place.

- `GET /v1/sun-moon/{date}`: Sun and moon for a date. Example: `/v1/sun-moon/2026-10-14?pincode=600001`

### Language and text

**Thirukkural** ([references/thirukkural.md](references/thirukkural.md)): All 1,330 kurals in Tamil with English translations.

- `GET /v1/thirukkural/{number}`: A kural by number. Example: `/v1/thirukkural/1`
- `GET /v1/thirukkural`: Search kurals. Example: `/v1/thirukkural?q=rain`
- `GET /v1/thirukkural/today`: Kural of the day. Example: `/v1/thirukkural/today?date=2026-10-13`
- `GET /v1/thirukkural/random`: A random kural. Example: `/v1/thirukkural/random`
- `GET /v1/thirukkural/chapters`: All 133 chapters. Example: `/v1/thirukkural/chapters`
- `GET /v1/thirukkural/chapters/{number}`: One chapter. Example: `/v1/thirukkural/chapters/2`

**Text tools** ([references/text.md](references/text.md)): Chunk documents, redact Indian identifiers, count tokens, detect language.

- `GET /v1/text/chunk`: Split a document into chunks. Example: `/v1/text/chunk?size=200&overlap=20&text=%23+Setup%0A%0AInstall+Go.+Clone+the+repository.%0A%0A%23+Deploy%0A%0APush+to+main.`
- `GET /v1/text/redact`: Redact Indian personal identifiers. Example: `/v1/text/redact?text=Call+98765+43210%2C+PAN+ABCPK1234F`
- `GET /v1/text/tokens`: Count tokens. Example: `/v1/text/tokens?model=gpt-4o&text=%E0%AE%B5%E0%AE%A3%E0%AE%95%E0%AF%8D%E0%AE%95%E0%AE%AE%E0%AF%8D%2C+how+many+tokens+is+this%3F`
- `GET /v1/text/language`: Detect the language. Example: `/v1/text/language?text=%E0%AE%85%E0%AE%95%E0%AE%B0+%E0%AE%AE%E0%AF%81%E0%AE%A4%E0%AE%B2+%E0%AE%8E%E0%AE%B4%E0%AF%81%E0%AE%A4%E0%AF%8D%E0%AE%A4%E0%AF%86%E0%AE%B2%E0%AF%8D%E0%AE%B2%E0%AE%BE%E0%AE%AE%E0%AF%8D+%E0%AE%86%E0%AE%A4%E0%AE%BF+%E0%AE%AA%E0%AE%95%E0%AE%B5%E0%AE%A9%E0%AF%8D+%E0%AE%AE%E0%AF%81%E0%AE%A4%E0%AE%B1%E0%AF%8D%E0%AE%B1%E0%AF%87+%E0%AE%89%E0%AE%B2%E0%AE%95%E0%AF%81`

**Transliteration** ([references/transliterate.md](references/transliterate.md)): Rewrite text between Indian scripts and Roman letters.

- `GET /v1/transliterate`: Transliterate text. Example: `/v1/transliterate?to=tamil&text=%E0%A4%A8%E0%A4%AE%E0%A4%B8%E0%A5%8D%E0%A4%A4%E0%A5%87+%E0%A4%AD%E0%A4%BE%E0%A4%B0%E0%A4%A4`

**Tamil legacy encodings** ([references/tamil-font.md](references/tamil-font.md)): Old Tamil text that shows as accented Latin letters, to Unicode and back.

- `GET /v1/tamil-font/convert`: Convert Tamil text. Example: `/v1/tamil-font/convert?from=tscii&text=%C2%BE%C3%81%C2%A2%C3%BA+%C3%85%C2%BD%C3%AC%C2%B8%C3%B5`
- `GET /v1/tamil-font/encodings`: Encodings offered. Example: `/v1/tamil-font/encodings`

### Network and contact checks

**IP address location** ([references/ip.md](references/ip.md)): IP address to country, state, city and network.

- `GET /v1/ip/{address}`: Location of an IP address. Example: `/v1/ip/49.204.0.1`
- `GET /v1/ip`: Location of your own address. Example: `/v1/ip`

**Email checks** ([references/email.md](references/email.md)): Is an email address well formed, throwaway, and able to receive mail.

- `GET /v1/email/{address}`: Check an email address. Example: `/v1/email/someone@mailinator.com`

**DNS check** ([references/dns.md](references/dns.md)): A domain's DNS records at four public resolvers at once.

- `GET /v1/dns/{name}`: Look up DNS records. Example: `/v1/dns/dharun.dev?type=MX`

**Phone numbers** ([references/phone.md](references/phone.md)): Check and format an Indian phone number, and see whose series it is.

- `GET /v1/phone/{number}`: Check a phone number. Example: `/v1/phone/+91%2095001%2012345`

**Traceroute from India** ([references/mtr.md](references/mtr.md)): The network path from a server in India to any host, with loss and latency per hop.

- `GET /v1/mtr/{host}`: Trace the route to a host. Example: `/v1/mtr/1.1.1.1`

### Developer tools

**Regex tester** ([references/regex.md](references/regex.md)): Run a regular expression against a text and see every match, explained.

- `GET /v1/regex`: Test a regular expression. Example: `/v1/regex?flags=i&pattern=%28%3F%3Cstate%3E%5BA-Z%5D%7B2%7D%29%5B+-%5D%3F%28%5Cd%7B2%7D%29&text=Cars+TN+37%2C+ka-05+and+MH12`

**Fake test data** ([references/fake.md](references/fake.md)): Made-up Indian people, companies and addresses for testing apps.

- `GET /v1/fake/{kind}`: Generate fake records. Example: `/v1/fake/people?count=3&state=TN&seed=42`

**Generated images** ([references/images.md](references/images.md)): Social preview images and code screenshots from a URL.

- `GET /v1/og-image`: Social preview image. Example: `/v1/og-image?title=Free%20APIs%20for%20Indian%20developers&subtitle=Pincodes%2C%20IFSC%2C%20holidays%20and%20more&site=api.dharun.dev`
- `GET /v1/code-image`: Code as an image. Example: `/v1/code-image?language=go&title=main.go&code=package+main%0A%0Aimport+%22fmt%22%0A%0Afunc+main%28%29+%7B%0A%09fmt.Println%28%22%E0%AE%B5%E0%AE%A3%E0%AE%95%E0%AF%8D%E0%AE%95%E0%AE%AE%E0%AF%8D%22%29%0A%7D`

### Sky and radio

**Satellite passes** ([references/satellites.md](references/satellites.md)): When the ISS and amateur radio satellites pass over you, and where they are now.

- `GET /v1/sat-pass`: Passes over a place. Example: `/v1/sat-pass?sat=ISS&pincode=600001`
- `GET /v1/satellites/{id}`: Where a satellite is now. Example: `/v1/satellites/ISS`
- `GET /v1/satellites`: Tracked satellites. Example: `/v1/satellites?group=stations`

**HF propagation** ([references/propagation.md](references/propagation.md)): Space weather and a rough rating of shortwave radio bands, day and night.

- `GET /v1/propagation`: Space weather and band conditions. Example: `/v1/propagation`

More: OpenAPI at https://api.dharun.dev/openapi.json, guides at https://api.dharun.dev/guides, the full documentation in one file at https://api.dharun.dev/llms-full.txt.