DEVELOPER API · REST · LIVE TODAY · ARC-MINUTE VERIFIED
The same engine behind every chart on this site, exposed as REST. 100% Bhāratīya mathematics — Sūrya-Siddhānta + Kerala Tantrasaṅgraha (1501) — Sun within ~0.1′ (p95), Moon within ~1′ of NASA/JPL Horizons. No foreign ephemeris anywhere in the numeric chain. The evaluation tier is live right now — the curl below runs without a key.
DOI 10.5281/zenodo.20024273 (v3 · 230 propositions published) · internal catalog 890 (publication pending) · AGPL → commercial bridge
| Graha | p95 error | max error |
|---|---|---|
| सूर्य Sūrya · Sun | 0.13′ | 0.21′ |
| चन्द्र Candra · Moon | 0.51′ | 1.0′ |
| शुक्र Śukra · Venus | 0.60′ | 1.5′ |
| मङ्गल Maṅgala · Mars | 0.91′ | 3.1′ |
| शनि Śani · Saturn | 1.0′ | 1.5′ |
| गुरु Guru · Jupiter | 1.2′ | 2.1′ |
| बुध Budha · Mercury | 2.2′ | 3.3′ |
Every graha stays within 3.3′ worst-case across fifty years. Method + raw residuals: /accuracy
Tier 1 · Free evaluation
परीक्षणम्
Parīkṣaṇam
₹0 live today · no card · no key
Rate-limited public endpoints
Tier 2 · Builder
निर्माता
Nirmātā
Introductory quoted per integration · request a key
Commercial use · closed-source permitted
Tier 3 · Enterprise
उद्यमः
Udyamaḥ
Custom annual contract · scoped SLA
White-label · institutional · regulated
Introductory pricing — a public API rate card is being finalised; until it ships, commercial terms are quoted per integration, in writing, and labelled introductory. What never changes: the prediction grammar at every endpoint is calculative and dated — mathematics, not mysticism · no fear · no remedies · no guarantees.
POST /api/chart — full chart computation (BirthChartInput)
curl -X POST https://bharatephemeris.com/api/chart \
-H "Content-Type: application/json" \
-d '{
"name": "Sample",
"year": 1990, "month": 8, "day": 15,
"hour": 4, "minute": 32,
"lat": 28.6139, "lon": 77.2090,
"tzHours": 5.5
}'POST /api/v1/bharat/chart — versioned sovereign-substrate chart
curl -X POST https://bharatephemeris.com/api/v1/bharat/chart \
-H "Content-Type: application/json" \
-d '{
"birthDate": "1990-08-15",
"birthTime": "04:32:00",
"birthPlace": { "lat": 28.6139, "lon": 77.2090, "tz": "Asia/Kolkata" },
"ayanamsa": "lahiri",
"nodeMode": "mean"
}'GET /api/panchang + /api/utsavas — pañcāṅga now · festivals by year
# current-instant pañcāṅga (accepts NO query parameters)
curl https://bharatephemeris.com/api/panchang
# festival calendar for any year 1900–2100
curl 'https://bharatephemeris.com/api/utsavas?year=2026'Full reference — every endpoint, request shape, rate limit and error envelope: /api-docs
| Endpoint | Computes | Limit |
|---|---|---|
| POST /api/chart | Full SovereignChart · 9 grahas · 16 vargas · KP sub-lord ladder · Vimśottarī tree | open · fair-use |
| POST /api/v1/bharat/chart | Versioned sovereign-substrate chart · sāyana + nirayana · rāśi/nakṣatra/pāda · lagna · tithi | open · fair-use |
| GET /api/panchang | Current-instant 5-limb pañcāṅga · vāra · tithi · nakṣatra · yoga · karaṇa | open · fair-use |
| GET /api/utsavas | Festival calendar for any year 1900–2100 · deterministic · ?year=YYYY | open · 1h edge cache |
| GET/POST /api/muhurta | 30 muhūrtas · choghaḍiyā · horā · Rāhu-kālam/Yamaganḍa/Gulika/Abhijit windows | 60 req/hr/IP |
| POST /api/rectify | Birth-time rectification · reverse-fit from dated life events · top 3-5 candidates | open · fair-use |
| POST /api/sahaja | Sahaja-Prajñā śāstric counsel · model-backed · chart/pañcāṅga tool calls mid-turn | 10 req/hr/IP |
| GET /api/health | Liveness + dependency-presence probe · booleans only · safe for uptime monitors | open |
Discovery surfaces also live under the same root — GET /api/press (machine-readable press facts), GET /api/rss + /api/rss/daily (feeds), /api/operator/dispatch (framework probe · 30 req/hr/IP). All documented at /api-docs.
Measured against NASA/JPL Horizons on 1,000 stratified samples spanning 2000–2050: Sun within ~0.1′ (p95), Moon within ~1′, every graha within 3.3′ worst-case — on 100% Bhāratīya mathematics (Sūrya-Siddhānta + Kerala Tantrasaṅgraha, 1501), zero foreign runtime. Your users' charts are computed on sovereign Indian theory, not a foreign-ephemeris wrapper. Full residuals at /accuracy.
The public endpoints are free to evaluate right now — no key, no card, rate-limited as listed above. There is no published API rate card yet: commercial (Builder) terms are quoted per integration and labelled introductory, and Enterprise is a custom contract. Email api@bharatephemeris.com with your platform, expected volume and integration surface — quotes are returned by email.
The engine source is AGPL-3.0. AGPL-compatible / open-source projects: free, no royalty. Closed-source or proprietary use needs the AGPL → commercial license bridge — that is what the Builder and Enterprise tiers are. Request terms at api@bharatephemeris.com.
They return calculative, dated structures — graha longitudes, daśā windows, muhūrta and transit windows — mathematics with shown derivation, not mysticism. The binding that holds at every endpoint: no fear-framing, no doṣa-and-remedy selling, no guaranteed outcomes. What you build on top of the computed windows is your product's responsibility.
Compute runs on Vercel serverless functions. Anonymous API calls are stateless — birth data is processed in-memory and not persisted. One exception, by design: if a request to POST /api/chart carries a signed-in session cookie from this site, the resulting chart is saved to that user's own dashboard (RLS-gated to their account). No third-party telemetry on birth data.
Not on the free evaluation tier — honesty over decoration. Liveness is publicly probeable at GET /api/health (status + dependency booleans, no secrets). Contractual SLA terms are scoped per Enterprise agreement, not claimed in marketing copy.
The free evaluation tier is live now. Builder & Enterprise keys — higher quotas, SLA, the sovereign no-Swiss engine you can license clean — are rolling out. Leave a work email and we’ll notify you the day commercial keys open.
आरम्भं कुरु
The engine is sovereign. The evaluation tier is live. Build the surface on it.
Read the reference · run the quickstart →Free evaluation needs no key and no card · commercial keys by request
Builder key → api@bharatephemeris.com · Enterprise → book a solutions call