Authentication

Send your key in the Authorization header of every request:

Authorization: Bearer al_test_…

These need no key at all: GET /v1/meta/conventions.

Key kinds

Test and live keys are secret. Use them only from your server, never in a web page or a mobile app.

Publishable keys

A publishable key can call only these operations:

• GET /v1/planets/now The sky now: sidereal positions at the top of the current hour
• GET /v1/outer-planets/cycle The retrograde cycle of Saturn, Uranus, Neptune or Pluto: its stations and whether it is retrograde now
• GET /v1/panchang Panchang for a date and place
• GET /v1/panchang/choghadiya Day and night choghadiya
• GET /v1/muhurat/activities Supported muhurat activities
• GET /v1/muhurat/day One day judged for an activity: the panchang, the verdict, the windows left after Rahu Kaal, Yamaganda and Gulika
• GET /v1/muhurat/{occasion}/year The dated muhurat list of a year for an occasion: the days that hold a window, with the windows
• GET /v1/muhurat/{occasion} Every local day between two dates for an occasion: available with its windows, or the reason it is not
• GET /v1/panchang/hora Hora: the 24 planetary hours of a day
• GET /v1/calendar/tithis Tithi start and end moments between two dates, and the tithi at each sunrise
• GET /v1/calendar/ekadashi Every Ekadashi of a year: the vrat date, the tithi and the paran window
• GET /v1/calendar/festivals Festivals of a year, each by its own rule, with its windows and moments
• GET /v1/horoscope/{sign} Horoscope for one sign
• GET /v1/horoscope All 12 signs (publisher feed)
• GET /v1/transits/events Planetary events: sign changes, retrograde stations and eclipses, with IST times
• GET /v1/transits Ingresses, stations and combustion between dates
• GET /v1/transits/graha-yuddha Graha yuddha (planetary war) now: Mercury, Venus, Mars, Jupiter and Saturn within 1.5°
• GET /v1/horoscope/weekly/rashi-tones The week's tone for each rashi: a 0–100 score per day, the band, the best and worst days and the planet behind it
• GET /v1/kp/ruling-planets The seven KP ruling planets at a moment and place
• GET /v1/kp/horary KP horary (prashna) for a number from 1 to 249
• GET /v1/vastu/reference The 32 padas with their door effects and verses, the 45 devatas, the room rules and the score's weights

The request's Origin header must exactly match one of the key's allowed origins, such as https://www.example.com. Otherwise the API answers 403 domain_not_allowed. Any other operation answers 403 scope_not_allowed.

Rotating a key

1. On API keys, choose Rotate. A new key with the same name and settings is created, and the old one keeps working.
2. Deploy the new key.
3. Revoke the old key. It stops working on the next request.

When a key is refused

Missing, malformed, unknown, revoked and expired keys all get the same answer, 401 invalid_api_key, so nobody can probe which keys exist.