Astrology API documentation

The Astrology API computes Vedic astrology over HTTPS. You send birth details as JSON and get charts, dashas, panchang, matching scores and written readings back as JSON. Every request goes to https://qastage01.apiforastrology.com/api/gateway with your API key in a header.

• Quickstart: make your first callGet a key and make your first call in a few minutes.
• Authentication and rate limitsSend your key in a header, keep it safe, and know your limits.
• Errors and how to handle themWhat each status code means and what to do about it.
• API referenceEvery endpoint, with examples you can run in the browser.
• ConventionsThe zodiac, houses, time zones, dates, language and text length.
• Vedic vs Western astrologyWhy Vedic signs differ from Western ones, and what to tell your users.
• Use with AI assistantsWhich endpoints to offer a chatbot as tools, and which fields to quote.

API reference by group

• Meta2 endpoints. Health, capabilities and limits for the service.
• Charts7 endpoints. Planets, the ascendant, the 16 divisional charts, aspects and strength.
• Dasha2 endpoints. Vimshottari and Yogini dashas with calendar dates for every period.
• Panchang4 endpoints. Five limbs, daily panchang, choghadiya, horas and rahu kaal.
• Interpretation3 endpoints. Yogas, doshas and sade sati. Each yoga and dosha states the classical rule it tested.
• Transits7 endpoints. Gochara snapshots, forecasts, ingresses and annual themes.
• Matching4 endpoints. Ashtakoot, dashakoot, parasparam and papa samyam comparisons.
• Reading9 endpoints. Topic readings, daily prose, karma and printable reports.
• Muhurta4 endpoints. Festival and vrat calendars for a year at a place, and times to begin an activity.

Want to see results before you sign up? Try the live demo on the Astrology API page.