Download

Astrology API reference

Updated Nov 7, 2026

The Astrology API reference from API for Astrology (apiforastrology.com) lists all 65 endpoints in 12 groups. Each endpoint shows its inputs, its response fields and a real recorded answer. Code comes in curl, JavaScript, Python and PHP. The OpenAPI file behind the reference also downloads, for Postman or code generators.

To send a test request, add your API key under Authentication, open an endpoint and choose Test Request.

About your key here: test requests are real calls that count toward your plan. The key you paste stays in this browser tab only. It stays until you close the tab or choose Forget my API key. It is only sent with your test requests.

Base URL: https://apiforastrology.com/api/astrology
Authentication: Authorization: Bearer or X-API-Key. Get a key
Guides: Docs overview, Quickstart, Authentication, Errors, Conventions, Sections and IDs, Ayanamsa, AI assistants, Changelog

Loading the interactive reference…

Endpoints by group

All 65 endpoints in 12 groups. Paths are relative to https://apiforastrology.com/api/astrology.

Charts

These endpoints work out the birth chart (kundli) itself. They cover planet positions, the ascendant (the sign rising at birth), the 16 divisional charts, aspects and planet strength, and the yearly chart (varshaphal). Most return numbers and placements only. The Jaimini, ashtakavarga and varshaphal endpoints also return short readings.

Birth chart (kundli) API reference: inputs, response fields and curl examples

Dasha

Dashas are planetary periods: a life is divided into periods, each ruled by one planet. Vimshottari is a 120-year cycle, returned with up to five levels of sub-periods and calendar dates. Yogini is a second system of 36 years. Ashtottari is a third, of 108 years, with a test of whether it applies to the chart. Narayana is a Jaimini dasha whose periods are run by signs, not planets.

Dasha API reference: inputs, response fields and curl examples

KP

Krishnamurti Paddhati (KP) is a school of its own. It uses its own ayanamsa (the starting point of the zodiac) and Placidus house cusps (the points where houses begin). Each planet and cusp gets its sign, star and sub lords, and each house gets its significators (the planets that deliver its results). KP is the only part of this API that uses Placidus cusps. Everywhere else houses are whole signs.

POST/v1/kpKrishnamurti Paddhati: cusps, sub lords, significators

KP astrology API reference: inputs, response fields and curl examples

Panchang

The panchang is the Hindu calendar's way of describing a day. It uses five elements: the lunar day, the Moon's nakshatra (one of 27 lunar mansions), yoga, karana and weekday. /v1/panchang reads them at a birth moment. /v1/panchang/daily and /v1/panchang/month need only a date and a place, and include the times each element changes.

Panchang API reference: inputs, response fields and curl examples

Interpretation

Findings about a chart, such as yogas (planetary combinations), doshas (unfavorable placements) and sade sati (a long Saturn transit). Each finding states the rule it applied and the chart facts that met it, so you can check the reasoning.

Yoga, dosha and sade sati API reference: inputs, response fields and curl examples

Remedies

Remedies a chart points to, each with the reason it was chosen. /v1/remedies/rudraksha picks rudraksha beads. /v1/remedies/charity and /v1/remedies/fasting give daan (charity) and vrat (fasting), each keyed on the planet the chart picks. The written remedies are reading sections: send the chart to /v1/reading/section/{section_id} with one of these ids. topic:remedy-life-gemstone and topic:remedy-lucky-gemstone give gemstones. topic:remedy-rudraksha gives the rudraksha reading, and topic:remedy-lucky-mantra the lucky mantra. topic:remedy-havan-puja covers havan (fire ritual) and puja. topic:remedy-general gives everyday remedies. topic:remedy-sadesati gives the remedies for sade sati (Saturn's 7.5-year transit). topic:remedy-kaal-sarp and topic:remedy-pitra-dosha give the remedies for those doshas (chart flaws).

Astrology remedies API reference: inputs, response fields and curl examples

Transits

Transits compare where the planets are now with where they were at birth (in Vedic astrology this is called gochara). The current-transit endpoint reads each planet from the birth Moon. It also applies vedha, a traditional rule by which one transiting planet blocks another's effect. The calendar endpoints give dates, and the /v1/sky endpoints describe the sky itself, with no chart. Every result names the rule it used.

Transit (gochar) API reference: inputs, response fields and curl examples

Matching

Compatibility between two people, as used for marriage matching in India. The main result is the 36-point ashtakoot score, built from eight factors called kootas. The response also shows the standard exceptions that cancel a zero score on a factor, and checks that are reported outside the score. A forecast for a couple is here too. The score is not symmetric, so requests name the two people bride and groom.

Kundli matching API reference: inputs, response fields and curl examples

Reading

Written readings. For a full chart reading, call /v1/reading/sections once to get the list of sections for a chart, then fetch the sections you need. Other endpoints here give a daily or weekly reading, a reading for a Moon sign, themed forecasts, a plain-language summary and a printable report. The text comes from the API's own library of written readings. Topics: Life Prediction (11), Monthly Forecast (6), Sade Sati (6), Remedies (9). Every topic is listed by GET /v1/reading/topics, with no chart needed, and in the table under /v1/reading/section/{section_id}.

Astrology reading API reference: inputs, response fields and curl examples

Horary

Horary (prashna): a question asked at a moment, read from a chart cast for that moment and place. You pick the topic from a list; a sentence is never read. The question chart describes the tendencies of the moment and is not a promise. Some questions are refused outright (lifespan, the sex of an unborn child, lotteries and gambling, medical diagnosis, accusing a person of a crime, testing), and a moment the classical texts call unfit to judge is refused too, with the reason. A refusal is 422 and carries no reading. Every route for questions asked at a moment is in this group.

Prashna (horary) API reference: inputs, response fields and curl examples

Muhurta

Dates and good times. The Hindu festival and fasting calendar for a year at a place. Also muhurtas (good times to start an activity): buying a vehicle, buying property, moving into a new home, and marriage, all checked against a published calendar: 161 of 161 festival dates, and all 579 published muhurta windows across those four activities and two years. Starting a business, travel and six child ceremonies (naming, first food, first haircut, ear piercing, start of learning, sacred thread) follow the classical rules and say they are not measured. Every answer names the rule that decided it. Nothing is scored or ranked.

Muhurat and festival dates API reference: inputs, response fields and curl examples