# BharatRouter

> India's AI gateway: Krutrim, Sarvam, and the world's best open and frontier models
> behind one API, with INR pricing, enforceable India data-residency
> (data_policy: india_only), and price/latency/uptime routing with automatic failover.
> The API speaks the OpenAI wire format — any standard SDK works with a base-URL swap.

Base URL: https://api.bharatrouter.com/v1
Auth: Authorization: Bearer br-... (sign up at https://bharatrouter.com/login; new orgs get ₹100 credit)
Billing: prepaid INR credits, per-token rates at https://bharatrouter.com/models
MCP server (for agents): POST https://api.bharatrouter.com/mcp (streamable HTTP, bearer key)

## Docs

- [Overview & quickstart](https://bharatrouter.com/docs): curl, Python, Node examples; streaming; embeddings
- [API reference](https://bharatrouter.com/docs/api-reference): every endpoint — inference, catalog, dashboard, webhooks — with request/response shapes
- [Routing & residency](https://bharatrouter.com/docs/routing): optimize (price|latency|uptime), provider pinning, data_policy: india_only, failover, circuit breakers
- [Collections](https://bharatrouter.com/docs/collections): shareable, versioned fallback chains — publish, fork-before-use, import into your routing
- [Reliability monitoring](https://bharatrouter.com/docs/monitoring): canary a collection's steps on a schedule; per-step uptime/p95 latency; error_rate/latency_p95 alerts via email/webhook (free in beta)
- [Bring your own endpoint (BYOE)](https://bharatrouter.com/docs/byoe): register your own OpenAI-compatible deployment as a ₹0 fallback step (byoe:slug) after a compliance test
- [API keys & limits](https://bharatrouter.com/docs/api-keys): trial vs standard tiers, rate limits, per-key monthly ₹ budgets, ephemeral keys
- [Audio](https://bharatrouter.com/docs/audio): speech-to-text (Whisper) and text-to-speech (Kokoro, Hindi voices)
- [BYOK](https://bharatrouter.com/docs/byok): bring your own Krutrim/Sarvam/Groq/Mistral/etc. keys; encrypted storage; model discovery as provider/model-id
- [Credits & billing](https://bharatrouter.com/docs/billing): topups (Razorpay, ₹100–₹1,000 in beta), promo codes, debits, receipts
- [Usage & activity](https://bharatrouter.com/docs/usage): token usage, per-request activity feed, public model rankings
- [Teams & workspaces](https://bharatrouter.com/docs/teams): org roles, workspaces, per-workspace monthly ₹ budgets
- [Errors](https://bharatrouter.com/docs/errors): JSON error envelope and every error code with handling guidance
- [MCP for agents](https://bharatrouter.com/docs/mcp): tools (list_models, chat, health, key management, collections, BYOE, monitoring), ephemeral sub-keys

## Machine-readable

- [llms-full.txt](https://bharatrouter.com/llms-full.txt): the whole reference in one fetch — endpoints, extensions, errors, BYOK, billing rules, MCP tools
- [OpenAPI 3.1 schema — inference](https://api.bharatrouter.com/openapi.json)
- [OpenAPI 3.1 schema — management API](https://api.bharatrouter.com/openapi-management.json): /me/* keys, budgets, BYOK, workspaces, billing
- [Gateway llms.txt](https://api.bharatrouter.com/llms.txt)
- [MCP server card](https://api.bharatrouter.com/.well-known/mcp/server-card.json)
- [Model catalog JSON](https://api.bharatrouter.com/v1/models): INR pricing, residency, languages, modalities, live health
- [Usage rankings JSON](https://api.bharatrouter.com/v1/rankings): most-used models, 7d/30d
- [Live status](https://status.bharatrouter.com)

## Quick example

POST https://api.bharatrouter.com/v1/chat/completions
Authorization: Bearer br-...
{"model": "krutrim-2", "messages": [{"role": "user", "content": "namaste"}],
 "data_policy": "india_only", "optimize": "price"}

The provider that served the request is echoed in the x-br-provider response header.