Docs menu

Download

Reading, festival and vrat IDs

Updated Nov 7, 2026

The IDs page of API for Astrology (apiforastrology.com) lists all 153 ids that astrology readings, remedies and festivals use. A written reading is split into sections, each with a stable id. Call POST /v1/reading/sections with a chart to get its section ids. Then fetch each section by its id.

Fetch one section with POST /v1/reading/section/{section_id}. Festivals and fasting days have ids of their own, and the summary and the annual forecast return their sections by id.

Use the ids to build a menu of reading cards. Then fetch a section only when the user opens its card. Readings that match the chart shows this pattern step by step. A chatbot can pick a topic id the same way, as the AI assistants guide explains. When we add a section, the changelog lists it.

Reading credits: see what each call uses.

Chart basics (7)

Send one to POST /v1/reading/section/{section_id}.

ID	What it is	Notes
`signature`	The day, colors, numbers and stones that suit this chart, read from the ascendant lord and the Moon-sign lord.	Always
`ascendant`	The rising sign (ascendant) and what it says about the person.	Always
`nakshatra`	The Moon's nakshatra (birth star), with its deity, mantra and remedy.	Always
`rashi`	The Moon sign (rashi) and what it says about the person.	Always
`birth-details`	The avakhada chakra: nakshatra and pada, name syllable, varna, yoni, gana and nadi, with the panchang at birth.	Always
`tensions`	Where the chart disagrees with itself: placements that pull two ways.	Always
`arudha`	The arudha lagna: how the person comes across to others.	When the chart's arudha can be worked out

Periods (dashas) (3)

Send one to POST /v1/reading/section/{section_id}.

ID	What it is	Notes
`dasha`	The three Vimshottari periods running now (main period, sub-period and the one inside it), with dates.	Always
`yogini`	The Yogini periods, a 36-year cycle.	Always
`ashtottari`	The Ashtottari periods, a 108-year cycle.	Always

Planets (9)

Send one to POST /v1/reading/section/{section_id}.

ID	What it is	Notes
`planet:Sun`	Sun: its sign, house and condition in this chart, and which way it leans.	Always
`planet:Moon`	Moon: its sign, house and condition in this chart, and which way it leans.	Always
`planet:Mars`	Mars: its sign, house and condition in this chart, and which way it leans.	Always
`planet:Mercury`	Mercury: its sign, house and condition in this chart, and which way it leans.	Always
`planet:Jupiter`	Jupiter: its sign, house and condition in this chart, and which way it leans.	Always
`planet:Venus`	Venus: its sign, house and condition in this chart, and which way it leans.	Always
`planet:Saturn`	Saturn: its sign, house and condition in this chart, and which way it leans.	Always
`planet:Rahu`	Rahu: its sign, house and condition in this chart, and which way it leans.	Always
`planet:Ketu`	Ketu: its sign, house and condition in this chart, and which way it leans.	Always

Houses (12)

Send one to POST /v1/reading/section/{section_id}.

ID	What it is	Notes
`house:1`	The 1st house: the area of life it covers, and what this chart puts there.	Always
`house:2`	The 2nd house: the area of life it covers, and what this chart puts there.	Always
`house:3`	The 3rd house: the area of life it covers, and what this chart puts there.	Always
`house:4`	The 4th house: the area of life it covers, and what this chart puts there.	Always
`house:5`	The 5th house: the area of life it covers, and what this chart puts there.	Always
`house:6`	The 6th house: the area of life it covers, and what this chart puts there.	Always
`house:7`	The 7th house: the area of life it covers, and what this chart puts there.	Always
`house:8`	The 8th house: the area of life it covers, and what this chart puts there.	Always
`house:9`	The 9th house: the area of life it covers, and what this chart puts there.	Always
`house:10`	The 10th house: the area of life it covers, and what this chart puts there.	Always
`house:11`	The 11th house: the area of life it covers, and what this chart puts there.	Always
`house:12`	The 12th house: the area of life it covers, and what this chart puts there.	Always

Yogas and transits (2)

Send one to POST /v1/reading/section/{section_id}.

ID	What it is	Notes
`yogas`	The yogas (planet combinations) this chart forms.	Always
`transits`	What the moving planets are doing over this chart now, counted from the Moon.	Always

Forecasts (2)

Send one to POST /v1/reading/section/{section_id}. forecast:year uses 3 reading credits; every other section uses 1.

ID	What it is	Notes
`forecast:month`	The month ahead.	Always
`forecast:year`	The year ahead, about 6,000 words.	Always

Doshas (3)

Send one to POST /v1/reading/section/{section_id}.

ID	What it is	Notes
`dosha:manglik`	Manglik (kuja) dosha: Mars in a house that affects marriage.	Only when the chart has it
`dosha:kaalsarpa`	Kaal sarp dosha: all seven planets from the Sun to Saturn on one side of Rahu and Ketu.	Only when the chart has it
`dosha:pitra`	Pitra dosha: a duty to the ancestors, read from the 9th house.	Only when the chart has it

Life Prediction (11)

Send one to POST /v1/reading/section/{section_id}. Every chart lists these topics.

ID	What it is	Notes
`topic:personality`	Who am I? Temperament, strengths, how others see you	Answer first, then the evidence
`topic:professional-life`	What work suits me? Fields, leadership, work-life balance	Answer first, then the evidence
`topic:love-and-marriage`	How do I love? Patterns, emotional needs, marriage	Answer first, then the evidence
`topic:wealth`	How do I earn, save and spend?	Answer first, then the evidence
`topic:education`	How do I learn best, and what study suits me?	Answer first, then the evidence
`topic:health-and-wellbeing`	How do I keep my energy, routine and rest in balance? (never a diagnosis)	Answer first, then the evidence
`topic:family-and-home`	Family bonds, home life, children and property	Answer first, then the evidence
`topic:life-purpose`	Where is my life heading? Direction and the turning points ahead	Answer first, then the evidence
`topic:friends-and-social`	How do I connect with people? Friends, groups, close bonds	Answer first, then the evidence
`topic:travel-and-relocation`	Short trips, long journeys, moving and living abroad	Answer first, then the evidence
`topic:favorable-periods`	Which of my life periods build, and which cost?

Monthly Forecast (6)

Send one to POST /v1/reading/section/{section_id}. Every chart lists these topics.

ID	What it is	Notes
`topic:monthly-career`	Work this month: the transits that touch it	Needs `as_of`: read for the month starting that date
`topic:monthly-love`	Love this month: the transits that touch it	Needs `as_of`: read for the month starting that date
`topic:monthly-wealth`	Money this month: the transits that touch it	Needs `as_of`: read for the month starting that date
`topic:monthly-days`	Which days this month go smoothly, and which need care?	Needs `as_of`: read for the month starting that date
`topic:monthly-tips`	Practical tips for this month	Needs `as_of`: read for the month starting that date
`topic:monthly-transits`	Every planet moving through the chart this month	Needs `as_of`: read for the month starting that date

Sade Sati (6)

Send one to POST /v1/reading/section/{section_id}. Every chart lists these topics.

ID	What it is	Notes
`topic:sadesati-predictions`	What does sade sati (Saturn's 7.5 years) mean for me?	Answers for the phase running on `as_of`; otherwise dated, not read
`topic:sadesati-expect`	What to expect during sade sati	Answers for the phase running on `as_of`; otherwise dated, not read
`topic:sadesati-rising`	The rising phase of sade sati	Answers for the phase running on `as_of`; otherwise dated, not read
`topic:sadesati-peak`	The peak phase of sade sati	Answers for the phase running on `as_of`; otherwise dated, not read
`topic:sadesati-setting`	The setting phase of sade sati	Answers for the phase running on `as_of`; otherwise dated, not read
`topic:sadesati-remedies`	Remedies for sade sati	Answers for the phase running on `as_of`; otherwise dated, not read

Remedies (9)

Send one to POST /v1/reading/section/{section_id}. Every chart lists these topics.

ID	What it is	Notes
`topic:remedy-life-gemstone`	My life gemstone, from the ascendant's ruler
`topic:remedy-lucky-gemstone`	A gemstone for the period I am in now	Follows the period running on `as_of`
`topic:remedy-rudraksha`	The rudraksha for my running period	Follows the period running on `as_of`
`topic:remedy-lucky-mantra`	The beej (seed) mantra for my running period, with its deity and japa count (how many times to say it)	Follows the period running on `as_of`
`topic:remedy-havan-puja`	Havan and puja for my running period	Follows the period running on `as_of`
`topic:remedy-general`	Everyday remedies for my running period	Follows the period running on `as_of`
`topic:remedy-sadesati`	Remedies for the sade sati phase I am in	Only when the chart has it
`topic:remedy-kaal-sarp`	Remedies for kaal sarp dosha	Only when the chart has it
`topic:remedy-pitra-dosha`	Remedies for pitra dosha	Only when the chart has it

Summary sections (12)

Returned in summary by POST /v1/summary, each with its title and text. A section with nothing calculated behind it is left out and named in gaps.

ID	What it is	Notes
`who-you-are`	In short
`strengths`	What comes easily
`effort`	What takes effort
`tensions`	Where life pulls two ways
`work`	Work and career
`money`	Money
`love`	Love and marriage
`health`	Health and energy
`features`	What stands out
`now`	Where you are now
`year-ahead`	The year ahead
`what-to-do`	What to do

Annual forecast sections (5)

Returned in sections by POST /v1/forecast/annual, each with its dated events.

ID	What it is	Notes
`annual:annual-career`	Career
`annual:annual-love`	Love
`annual:annual-finance`	Finance
`annual:annual-periods`	Periods
`annual:annual-remedies`	Remedies

Festivals (58)

Send one to GET /v1/festivals/{slug}. GET /v1/festivals returns them all for a year and place.

ID	What it is	Notes
`makar-sankranti`	Makar Sankranti	Date: the day the Sun enters Makara, if it enters before sunset; otherwise the following day
`ganesh-jayanti`	Ganesh Jayanti	Date: the only day the tithi holds madhyahna
`vasant-panchami`	Vasant Panchami	Date: the only day the tithi holds purvahna
`ratha-saptami`	Ratha Saptami	Date: the only day the tithi holds sunrise
`maha-shivaratri`	Maha Shivaratri	Date: the only day the tithi holds nishita
`holika-dahan`	Holika Dahan	Date: the only day the tithi holds pradosh
`holi`	Holi	Date: the day after Holika Dahan
`rang-panchami`	Rang Panchami	Date: the only day the tithi holds sunrise
`gudi-padwa`	Gudi Padwa	Date: the only day the tithi holds sunrise
`chaitragaur`	Chaitra Gauri (Gauri Tritiya)	Date: the only day the tithi holds sunrise
`ram-navami`	Ram Navami	Date: the only day the tithi holds madhyahna
`hanuman-jayanti`	Hanuman Jayanti	Date: the only day the tithi holds sunrise
`akshaya-tritiya`	Akshaya Tritiya	Date: the tithi holds this sunrise for at least six ghatis
`vat-purnima`	Vat Purnima	Date: the only day the tithi holds madhyahna
`gauri-vrat`	Gauri Vrat (Molakat)	Date: the only day the tithi holds sunrise
`jaya-parvati-vrat`	Jaya Parvati Vrat	Date: the tithi holds sunrise on 2 days; the first was taken
`guru-purnima`	Guru Purnima	Date: the only day the tithi holds sunrise
`nag-panchami`	Nag Panchami	Date: the tithi holds pratah on 2 days; the day with the greater share was taken
`narali-purnima`	Narali Purnima	Date: the only day the tithi holds sunrise
`raksha-bandhan`	Raksha Bandhan	Date: the only day the tithi holds aparahna
`randhan-chhath`	Randhan Chhath	Date: the only day the tithi holds sunrise
`krishna-janmashtami`	Krishna Janmashtami	Date: the only day the tithi holds nishita
`shitala-satam`	Shitala Satam	Date: the only day the tithi holds sunrise
`gopalkala`	Gopalkala (Dahi Handi)	Date: the only day the tithi holds sunrise
`pithori-amavasya`	Pithori Amavasya	Date: the only day the tithi holds aparahna
`pola`	Pola (Bail Pola)	Date: the only day the tithi holds sunrise
`hartalika`	Hartalika Teej	Date: the only day the tithi holds sunrise
`ganesh-chaturthi`	Ganesh Chaturthi	Date: the only day the tithi holds madhyahna
`rishi-panchami`	Rishi Panchami	Date: the only day the tithi holds madhyahna
`gauri-avahan`	Gauri Avahan	Date: the only day Anuradha holds sunrise
`gauri-pujan`	Gauri Pujan	Date: the only day Jyeshtha holds sunrise
`gauri-visarjan`	Gauri Visarjan	Date: the only day Mool holds sunrise
`anant-chaturdashi`	Anant Chaturdashi (Ganesh visarjan)	Date: the only day the tithi holds sunrise
`sarva-pitru-amavasya`	Sarva Pitru Amavasya	Date: the only day the tithi holds aparahna
`navratri-ghatasthapana`	Navratri begins (Ghatasthapana)	Date: the only day the tithi holds sunrise
`saraswati-avahan`	Saraswati Avahan	Date: the only day Mool holds madhyahna
`saraswati-puja`	Saraswati Puja	Date: the only day Purva Ashadha holds madhyahna
`dussehra`	Dussehra (Vijayadashami)	Date: the only day the tithi holds aparahna
`sharad-purnima`	Sharad Purnima (Kojagiri)	Date: the tithi holds nishita on no day; kept on the civil day it mostly falls in
`karva-chauth`	Karva Chauth	Date: the only day the tithi holds moonrise
`vasubaras`	Vasubaras (Vagh Baras)	Date: the only day the tithi holds pradosh
`dhanteras`	Dhanteras	Date: the only day the tithi holds pradosh
`kali-chaudas`	Kali Chaudas	Date: the only day the tithi holds nishita
`narak-chaturdashi`	Narak Chaturdashi	Date: the only day the tithi holds sunrise
`diwali`	Diwali (Lakshmi Puja)	Date: the only day the tithi holds pradosh
`annakut`	Annakut	Date: the only day the tithi holds aparahna
`balipratipada`	Balipratipada (Diwali Padwa)	Date: the only day the tithi holds aparahna
`bestu-varas`	Bestu Varas (Gujarati New Year)	Date: the only day the tithi holds sunrise
`govardhan-puja`	Govardhan Puja	Date: the only day the tithi holds sunrise
`bhai-dooj`	Bhai Dooj	Date: the only day the tithi holds aparahna
`labh-pancham`	Labh Pancham	Date: the only day the tithi holds pratah
`chhath-puja`	Chhath Puja (Sandhya Arghya)	Date: the only day the tithi holds sunrise
`prabodhini-ekadashi`	Prabodhini (Dev Uthani) Ekadashi	Date: Ekadashi holds this sunrise and Dwadashi holds the next, so the fast can be broken within Dwadashi
`tulsi-vivah`	Tulsi Vivah	Date: the only day the tithi holds sunrise
`dev-diwali`	Dev Diwali	Date: the tithi holds this sunrise for at least six ghatis
`tripurari-purnima`	Tripurari Purnima	Date: the only day the tithi holds sunrise
`champa-shashthi`	Champa Shashthi	Date: the only day the tithi holds aparahna
`datta-jayanti`	Datta Jayanti	Date: the only day the tithi holds sunrise

Fasting days (vrats) (8)

Pass one or more in kind to GET /v1/vrats, such as kind=ekadashi,pradosh.

ID	What it is	Notes
`ekadashi`	Shattila Ekadashi, Jaya Ekadashi, Vijaya Ekadashi	24 in 2026
`pradosh`	Guru Pradosh, Shukra Pradosh, Shani Pradosh	24 in 2026
`sankashti-chaturthi`	Lambodara Sankashti, Dwijapriya Sankashti, Bhalachandra Sankashti	13 in 2026
`masik-shivaratri`	Masik Shivaratri, Maha Shivaratri, Sawan Shivaratri	12 in 2026
`purnima`	Pausha Purnima, Magha Purnima, Phalguna Purnima	13 in 2026
`purnima-vrat`	Pausha Purnima vrat, Magha Purnima vrat, Phalguna Purnima vrat	13 in 2026
`amavasya`	Magha Amavasya, Phalguna Amavasya, Chaitra Amavasya	12 in 2026
`darsha-amavasya`	Darsha Amavasya	12 in 2026

Next steps

From the blog