Rate limits and credits
Plans
| Plan | Credits a month | Requests a second | Requests at once | When credits run out | Test calls a day |
|---|---|---|---|---|---|
| Free | 3,000 | 2 | 2 | Calls stop with 429 quota_exhausted | 100 |
| Starter | 75,000 | 5 | 4 | Calls continue as overage | 100 |
| Growth | 4,00,000 | 20 | 8 | Calls continue as overage | 100 |
| Business | 15,00,000 | 50 | 16 | Calls continue as overage | 100 |
Limits apply per key: requests per second, and requests in flight at once.
Headers
Every authenticated response carries:
| Header | Meaning |
|---|---|
RateLimit-Limit | Requests allowed in the current window. |
RateLimit-Remaining | Requests left in the current window. |
RateLimit-Reset | Seconds until the window resets. |
X-Credits-Remaining | Credits left in the billing period. |
A 429 also carries Retry-After, in seconds.
Two kinds of 429
rate_limited: too many requests per second or at once. WaitRetry-Afterseconds, then retry.quota_exhausted: the period's credits are used up on a plan that stops at its allowance, or the project's test calls for the day are used up.- Test calls reset at 00:00 UTC.
- Credits reset at the start of each UTC month.
Credits per operation
Only successful (2xx) calls are charged. Test keys are never charged.
| Operation | Credits |
|---|---|
GET /v1/places/search Search birth places | 1 |
GET /v1/places/{place_id} Get one place | 1 |
GET /v1/places/reverse Nearest real settlement to coordinates | 1 |
POST /v1/timezone IANA zone and UTC offset at a moment and place | 1 |
POST /v1/kundli Birth chart: lagna and the nine grahas | 2 |
POST /v1/kundli/birth-details Avakhada birth details | 1 |
POST /v1/kundli/divisional Divisional charts D1–D60 | 2 |
POST /v1/kundli/aspects Graha drishti: houses and planets aspected | 1 |
POST /v1/kundli/yogas Yogas present, with strength and rule | 2 |
POST /v1/kundli/ashtakavarga Bhinna and Sarva Ashtakavarga | 2 |
POST /v1/kundli/shadbala Shadbala: the six-fold strength of the seven grahas | 2 |
POST /v1/planets/positions Sidereal positions at any moment and place | 1 |
POST /v1/dasha/vimshottari Vimshottari periods to 5 levels | 2 |
POST /v1/dasha/vimshottari/current Running Maha → Antar → Pratyantar → Sookshma | 2 |
POST /v1/dasha/yogini Yogini dasha periods | 2 |
POST /v1/dasha/chara Jaimini Chara dasha and the karakas | 2 |
POST /v1/dosha/manglik Manglik: graded, from lagna, Moon and Venus, cancellations named | 1 |
POST /v1/dosha/kaal-sarp Kaal Sarp: none, partial or full | 1 |
POST /v1/dosha/sade-sati Sade Sati: is it running today, which phase, and when it ends | 1 |
POST /v1/match/ashtakoot Ashtakoot Guna Milan (36 points) | 1 |
POST /v1/match/manglik Manglik status of both and mutual cancellation | 2 |
GET /v1/panchang Panchang for a date and place | 1 |
GET /v1/panchang/choghadiya Day and night choghadiya | 1 |
GET /v1/muhurat/activities Supported muhurat activities | 0 |
GET /v1/muhurat/search Days rated for an activity, with scores and rejection reasons | 2 |
POST /v1/muhurat/personal Muhurat windows with tara bala and chandra bala for one person | 3 |
GET /v1/panchang/hora Hora: the 24 planetary hours of a day | 1 |
GET /v1/calendar/tithis Tithi start and end moments between two dates, and the tithi at each sunrise | 1 |
GET /v1/calendar/ekadashi Every Ekadashi of a year: the vrat date, the tithi and the paran window | 1 |
GET /v1/calendar/festivals Festivals of a year, each by its own rule, with its windows and moments | 2 |
GET /v1/horoscope/{sign} Horoscope for one sign | 1 |
GET /v1/horoscope All 12 signs (publisher feed) | 5 |
POST /v1/horoscope/personal A horoscope from the person's own Moon sign | 2 |
GET /v1/transits Ingresses, stations and combustion between dates | 1 |
POST /v1/transits/natal Transits over the natal Moon and houses | 2 |
POST /v1/numerology/core Life path, destiny, soul urge, personality (Chaldean) | 1 |
POST /v1/numerology/name Chaldean name number | 1 |
POST /v1/numerology/mobile Mobile-number analysis | 1 |
POST /v1/numerology/loshu Lo Shu grid | 1 |
POST /v1/numerology/compatibility Numerology compatibility | 1 |
POST /v1/charts/{varga}.svg Chart as SVG (North or South Indian) | 2 |
POST /v1/charts/{varga}.png Chart as PNG (the same drawing as the SVG) | 3 |
POST /v1/kp/chart KP chart: cusps and planets with star, sub and sub-sub lords | 2 |
POST /v1/kp/significators KP 4-step significators and house groups | 2 |
GET /v1/kp/ruling-planets The seven KP ruling planets at a moment and place | 1 |
GET /v1/kp/horary KP horary (prashna) for a number from 1 to 249 | 2 |
POST /v1/lal-kitab/chart Lal Kitab teva: houses, planet states, sleeping houses | 2 |
POST /v1/lal-kitab/debts The nine Lal Kitab rin (debts), graded | 1 |
POST /v1/lal-kitab/varshphal Lal Kitab annual chart for a year of life | 2 |
POST /v1/lal-kitab/remedies Lal Kitab remedies, in the order to do them | 1 |
POST /v1/varshaphal Tajik varshaphal: annual chart, muntha, year lord, Mudda dasha | 3 |
GET /v1/usage Credits used and remaining this period | 0 |
GET /v1/meta/conventions Defaults and conventions (ayanamsa, node, sunrise definition, what is not computed) | 0 |