Authentication
All requests are authenticated with an API key sent as a bearer token. Create and manage keys from your dashboard. Keys are shown in full exactly once at creation — store them securely; you can rotate or revoke them anytime.
Authorization: Bearer YOUR_API_KEYQuickstart
Generate a birth chart in one call. The response includes planetary positions, ascendant, houses, nakshatras and the Vimshottari dasha timeline.
curl -X POST https://api.panditai.com/api/v1/kundali/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Aryabhata",
"date": "1990-08-15",
"time": "05:30",
"place": "Mumbai, India"
}'Credits & rate limits
Calls draw from your account’s credit balance. Deterministic calculations are cheap; AI-written interpretations cost more. Premium chart systems are charged once per report and are free to re-view after that.
| Action | Cost |
|---|---|
| Generate Kundali | 10 credits |
| Gun Milan compatibility | 15 credits |
| KP / Jaimini / Shodashvarga | 5 credits each (charged once, then free to re-view) |
| Doshas, remedies, predictions, horoscope, numerology | Free |
Rate limit: 60 requests/minute per key by default. Need more? See plans.
Kundali & Charts
Generate a birth chart from Swiss Ephemeris, then unlock divisional and advanced chart systems.
/kundali/generateGenerate a Kundali (birth chart) from name, date, time and place.
/kundaliList all Kundali reports for the authenticated account.
/kundali/{id}Fetch a single Kundali report by id.
/kundali/{id}/shodashvargaCompute the 16 Shodashvarga divisional charts (D1–D60).
/kundali/{id}/kpCompute KP (Krishnamurti Paddhati) sub-lords and significators.
/kundali/{id}/jaiminiCompute Jaimini chara karakas and arudha padas.
/kundali/{id}/shareCreate a public, read-only share link for a report.
/kundali/{id}Delete a Kundali report.
Predictions & Doshas
Life-area predictions and full dosha analysis grounded in the calculated chart.
/predictions/generate/{reportId}Generate life-area predictions from a saved Kundali report.
/predictions/{reportId}Retrieve previously generated predictions for a report.
/doshas/{id}Detailed analysis of Mangal, Kaal Sarp, Pitru, Guru Chandal and Kemdrum doshas with cancellations.
Remedies
Classical remedial measures — general and personalised to a chart’s afflictions.
/remedies/{reportId}Personalised remedies for a report’s afflicted planets.
/remedies/generalGeneral, chart-independent Vedic remedies.
Compatibility
Ashtakoot Gun Milan matchmaking across all eight kootas.
/compatibility/matchGenerate a 36-point Ashtakoot Gun Milan report with per-koota scores and cancellations.
Horoscope
Daily rashi horoscopes for the twelve signs.
/horoscope/dailyDaily horoscope for all 12 rashis.
/horoscope/generateGenerate a horoscope for a single rashi.
Numerology
Pythagorean and Chaldean numerology profiles and name suggestions.
/numerology/calculateCalculate a full numerology profile (free).
/numerology/suggest-namesSuggest business or baby names for a target number.
Muhurat & Panchang
Auspicious timing and daily Panchang.
/muhurat/panchangPanchang and Muhurat slots for a given date and place.
/muhurat/best-datesFind the best Muhurat dates within a date range.
Account & Keys
Manage API keys and check your credit balance.
/credits/balanceCurrent credit balance for the account.
/credits/historyCredit transaction history.
/api-keysCreate a new API key with scoped permissions.
/api-keysList your API keys (prefixes only — full keys are shown once).
/api-keys/{keyId}/rotateRotate (regenerate) an API key.
/api-keys/{keyId}Revoke an API key.
Full reference
This page covers the most-used endpoints. The complete, always-current specification — every endpoint, parameter and schema — is published as OpenAPI and can be imported into Postman, Insomnia or any code generator.