# Astrologics API
> Vedic astrology API for India: kundli, dasha, doshas, matchmaking, panchang and muhurat, horoscopes, transits, numerology and chart images. JSON over HTTPS with one Bearer key; the timezone is worked out from the place and date; English and Hindi.

Base URL: https://api.astrologics.in/v1. OpenAPI 3.1: https://developers.astrologics.in/reference/openapi.yaml

## Docs
- [Quickstart](https://developers.astrologics.in/docs/quickstart.md): Your first Astrologics API call in five minutes, with curl, Node.js, Python or PHP.
- [Authentication](https://developers.astrologics.in/docs/authentication.md): API keys (test, live, publishable), how to send them, rotation and revocation.
- [The birth object](https://developers.astrologics.in/docs/birth-input.md): How to send a birth date, time and place, how timezones are resolved, and what happens when the time is unknown.
- [Errors](https://developers.astrologics.in/docs/errors.md): The error envelope, every error code, and what to do about each.
- [Rate limits and credits](https://developers.astrologics.in/docs/rate-limits.md): Requests per second, requests at once, credits per operation, and the headers that tell you where you stand.
- [Conventions](https://developers.astrologics.in/docs/conventions.md): The ayanamsa, node, house system and sunrise definition the API computes with, and what it does not compute.
- [Accuracy](https://developers.astrologics.in/docs/accuracy.md): How we measure the engine against NASA JPL Horizons, the figures, and a test set you can check yourself.
- [Versioning and calculation changes](https://developers.astrologics.in/docs/versioning-and-calculation-changes.md): How the API evolves, what counts as breaking, and how calculation changes are announced.
- [Caching and data retention](https://developers.astrologics.in/docs/caching-and-data-retention.md): What you may cache, and what we keep (nothing from your requests).
- [Mobile apps](https://developers.astrologics.in/docs/mobile-apps.md): Never put a secret key in an app; call the API from your server, or use a publishable key.
- [Languages](https://developers.astrologics.in/docs/languages.md): English and Hindi today, and how the lang parameter works.

## API reference
- [Full reference](https://developers.astrologics.in/reference.md)
- [Places & time](https://developers.astrologics.in/reference/places-and-time.md): Resolve a birth place (5.17M places, India-aware) and the timezone at a moment — historical offsets included.
- [Kundli](https://developers.astrologics.in/reference/kundli.md): The birth chart: lagna, the nine grahas, divisional charts, aspects, yogas, Ashtakavarga, positions at any moment.
- [Dasha](https://developers.astrologics.in/reference/dasha.md): Vimshottari periods to four levels and the periods running at a given moment.
- [Doshas](https://developers.astrologics.in/reference/doshas.md): Manglik (graded, cancellations named), Kaal Sarp (none/partial/full) and Sade Sati.
- [Matchmaking](https://developers.astrologics.in/reference/matchmaking.md): Ashtakoot Guna Milan and Manglik compatibility for two people.
- [Panchang & muhurat](https://developers.astrologics.in/reference/panchang-and-muhurat.md): Daily panchang, choghadiya, and muhurat windows with scores and rejection reasons.
- [Calendar](https://developers.astrologics.in/reference/calendar.md): Tithi start and end moments, every Ekadashi of a year with its paran window, and the festivals, each by its stated rule.
- [Horoscopes](https://developers.astrologics.in/reference/horoscopes.md): Transit-based horoscopes per sign and period, in English and Hindi.
- [Transits](https://developers.astrologics.in/reference/transits.md): Sign ingresses, retrograde/direct stations and combustion between two dates.
- [Numerology](https://developers.astrologics.in/reference/numerology.md): Chaldean numerology: core numbers, name, mobile number, Lo Shu grid, compatibility.
- [Chart images](https://developers.astrologics.in/reference/chart-images.md): Charts drawn server-side as SVG, North or South Indian style.
- [KP](https://developers.astrologics.in/reference/kp.md): Krishnamurti Paddhati: cusps and sub lords, 4-step significators, ruling planets, horary.
- [Lal Kitab](https://developers.astrologics.in/reference/lal-kitab.md): Lal Kitab: the teva, planet states, the nine debts, the annual chart and remedies.
- [Annual](https://developers.astrologics.in/reference/annual.md): Tajik varshaphal: the solar-return chart for a year of life.
- [Platform](https://developers.astrologics.in/reference/platform.md): Your usage and the conventions this API computes with.

## Products
- [Places & time](https://developers.astrologics.in/products/places-and-time.md)
- [Kundli](https://developers.astrologics.in/products/kundli.md)
- [Dasha](https://developers.astrologics.in/products/dasha.md)
- [Doshas](https://developers.astrologics.in/products/doshas.md)
- [Matchmaking](https://developers.astrologics.in/products/matchmaking.md)
- [Panchang & muhurat](https://developers.astrologics.in/products/panchang-and-muhurat.md)
- [Calendar](https://developers.astrologics.in/products/calendar.md)
- [Horoscopes](https://developers.astrologics.in/products/horoscopes.md)
- [Transits](https://developers.astrologics.in/products/transits.md)
- [Numerology](https://developers.astrologics.in/products/numerology.md)
- [Chart images](https://developers.astrologics.in/products/chart-images.md)
- [KP](https://developers.astrologics.in/products/kp.md)
- [Lal Kitab](https://developers.astrologics.in/products/lal-kitab.md)
- [Annual](https://developers.astrologics.in/products/annual.md)
- [Platform](https://developers.astrologics.in/products/platform.md)

## Other
- [Postman collection](https://developers.astrologics.in/reference/postman.json)
- [Changelog](https://developers.astrologics.in/changelog)
- [Pricing](https://developers.astrologics.in/pricing)