India API

India API

Free, open source APIs for Indian data. Pincodes, IFSC and bank branches, GSTIN and PAN checks, bank and market holidays, RTO codes, company logos, UPI QR codes, numbers in lakh and crore, GST invoices as PDF, OCR in Indian languages, PDF and image tools, translation, speech to text and text to speech, and more: 44 APIs behind one consistent JSON shape. No API key, no sign-up, open CORS, and an MCP server so AI assistants can use it too.

Documentation: [api.dharun.dev](https://api.dharun.dev) · API reference · Guides · Use with AI · OpenAPI · llms.txt

curl https://api.dharun.dev/v1/pincode/637001

{

"data": { "pincode": "637001", "district": "Namakkal", "stateCode": "TN", "state": "Tamil Nadu", "offices": [ ... ] }, "meta": { "source": { "name": "...", "licence": "...", "attribution": "..." } } }

APIs

Each name links to its page, with every parameter, a real response and code in curl, JavaScript and Python.

One shape everywhere

• Every JSON response is { "data": ..., "meta": { ... } }. data is an object, or an array for list endpoints, which add meta.total, meta.limit and meta.offset.
• meta.source names the dataset, its version, its licence and the credit it asks for.
• Errors are { "error": { "code", "message" } } with a matching HTTP status.
• Each client has an allowance of 600 requests a minute. A lookup costs 1; a request that takes real CPU work (image rendering, astronomy, live DNS) costs 10, a file upload 15, and a neural network job (speech, speech to text, translation, background removal, denoise) 30. Embeddings, reranking and moderation count as CPU work.
• Text endpoints take ?text=, or a POST body as text/plain or JSON {"text": "..."}.
• Image endpoints return the image itself, ready for an tag; PDF and audio endpoints return the file.
• File endpoints take a POST of the file as the body, or as multipart/form-data, up to 10 MB. Files are deleted when the answer is sent; nothing is kept.

Use it from AI assistants

One MCP server, one Agent Skill and one Claude Code plugin cover every API.

# Claude Code: the MCP server

claude mcp add --transport http india-api https://api.dharun.dev/mcp

Claude Code: the plugin (skill and MCP server together)

/plugin marketplace add dharunashokkumar/api.dharun.dev /plugin install india-api@dharun-dev

Any agent that reads Agent Skills (Claude Code, Codex, Copilot, Cursor, Gemini CLI)

npx skills add dharunashokkumar/api.dharun.dev

• MCP server: https://api.dharun.dev/mcp, Streamable HTTP, stateless, no authentication. Each tool returns exactly what the matching REST endpoint returns. Setup for Claude, ChatGPT, VS Code, Cursor, Windsurf, Gemini CLI and Codex: api.dharun.dev/ai. In the MCP Registry as io.github.dharunashokkumar/india-api.
• Agent Skill: skills/india-api.
• Claude Code plugin: plugins/india-api, with the marketplace in .claude-plugin/marketplace.json.
• For crawlers and agents: /llms.txt, /llms-full.txt, every page as Markdown (add .md or send Accept: text/markdown), /openapi.json, an MCP server card, an AI catalog and an API catalog under /.well-known/.

The skill, the plugin and server.json are generated from the catalog in internal/api/catalog.go; a test fails when the committed copies are out of date.

Licence

• Calling the API puts no licence on your app.
• The code is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only). If you run a modified copy as a service for others, you must offer them your changes.
• **Code examples, the guides' code, the Agent Skill and the C