New Numerology API
Docs menu
Download

Astrology remedies API reference

Updated

The remedy endpoints of API for Astrology (apiforastrology.com) suggest the remedies a birth chart points to. Rudraksha beads, charity (daan) and fasting (vrat) come as data, each with its reason. Gemstone, mantra, puja and dosha remedies come as written readings. Those readings use reading credits on live keys. The page covers 3 endpoints and 9 remedy readings.

Start with POST /v1/remedies/rudraksha, POST /v1/remedies/charity or POST /v1/remedies/fasting. Each takes the same birth details as a chart. For a written remedy, send the chart to POST /v1/reading/section/{section_id} with a remedy id, such as topic:remedy-life-gemstone. The Sections and IDs page lists every remedy id. The fasting answer comes with a doctor caution, so show it beside the fast.

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).

3 endpoints and 9 remedy readings. Paths are relative to https://apiforastrology.com/api/astrology. Send your API key in the Authorization: Bearer header (see authentication). No key yet? Get a key. To send test requests from the browser, open the interactive reference.

Overview: Remedies.

Which remedy endpoint to call

What you needEndpointCost
The rudraksha beads a chart points to, as data. Start herePOST /v1/remedies/rudraksha1 call
What to give, to whom and on which day, with the reason for eachPOST /v1/remedies/charity1 call
Which weekday fasts to keep and what the one meal can be, with a doctor cautionPOST /v1/remedies/fasting1 call
The gemstone for life, chosen from the ascendant lord, with why and how to wear it.POST /v1/reading/section/topic:remedy-life-gemstone1 reading credit
The gemstone for the period you are in now, chosen from the running mahadasha lord.POST /v1/reading/section/topic:remedy-lucky-gemstone1 reading credit
The rudraksha bead for the period you are in now, as a written reading.POST /v1/reading/section/topic:remedy-rudraksha1 reading credit
The beej (seed) mantra of the running mahadasha lord, with its japa count (how many times to say it) and its deity.POST /v1/reading/section/topic:remedy-lucky-mantra1 reading credit
The havan (fire ritual) and puja that suit the running mahadasha lord.POST /v1/reading/section/topic:remedy-havan-puja1 reading credit
Everyday remedies for the period you are in now, chosen from the running mahadasha lord.POST /v1/reading/section/topic:remedy-general1 reading credit
Remedies for sade sati, Saturn's 7.5-year transit around your Moon sign.POST /v1/reading/section/topic:remedy-sadesati1 reading credit
Remedies for kaal sarp dosha, when all seven planets from the Sun to Saturn sit on one side of Rahu and Ketu.POST /v1/reading/section/topic:remedy-kaal-sarp1 reading credit
Remedies for pitra dosha, a duty to your ancestors read from the ninth house.POST /v1/reading/section/topic:remedy-pitra-dosha1 reading credit

Rudraksha recommendation: which bead, and why

POST /v1/remedies/rudraksha

Returns the rudraksha beads this chart points to, each with the reason it was chosen. A rudraksha is the seed of a tree linked with Shiva, worn as a bead. Its mukhi is the number of natural faces on it, and each mukhi is linked with one planet.

Three ways a chart chooses a bead, each reported in reasons:

  • The lord of the ascendant, for life.
  • The lord of the mahadasha (main period) running on as_of, for that period.
  • The lord of the birth nakshatra, for life.

When two name the same planet, the bead is listed once with both reasons.

The mukhi table is one school among several. It is returned in scheme: 1 Sun, 2 Moon, 3 Mars, 4 Mercury, 5 Jupiter, 6 Venus, 7 Saturn, 8 Rahu, 9 Ketu. The period remedy in the reading uses the same table. For the Sun the twelve-mukhi is reported as alternative, since it is the bead more often worn.

Wearing guidance is limited to the day to begin, the thread color, the metal if capped, and the planet's beeja mantra. Nothing here is a health claim or a guarantee: not_claimed says so, and the not_a_guarantee text says it in the reader's language. A bead with a caution is still returned, with caution beside it. Examples are the Rahu and Ketu beads, worn for a period, and the rare one-mukhi. See rulebook RM-06 to RM-08.

Cost: Each successful request counts as 1 call toward your monthly calls.

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.
Optional inputs (9), with their defaults
NameInWhat it does
langqueryLanguage of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too.
detailqueryLength of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field.
as_ofqueryDate for the running mahadasha, YYYY-MM-DD. Defaults to today. Set it if you need the same response on every call.
hourbodyHour of birth on the local clock at the birth place, from 0 to 23 (24-hour clock). Default 0.
minutebodyMinute of birth, from 0 to 59. Default 0.
secondbodySecond of birth, from 0 to 59. Default 0.
timezone_foldbodyOnly needed for a local time that happens twice, on the night the clocks go back. In the US since 2007, that is 1:00 to 1:59 AM on the first Sunday in November. 0 picks the first occurrence (before the change) and 1 the second. Without it, such a time is rejected, not guessed. A wrong guess would quietly move the chart by an hour. A local time that never happens, because the clocks jumped forward over it, is also rejected; check the birth time, or send the UTC offset that was in force.
ayanamsabodyThe ayanamsa: the offset between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). lahiri (the default) is the Lahiri, or Chitrapaksha, ayanamsa used by the Government of India. kp is the Krishnamurti ayanamsa used in KP astrology, about 6 arcminutes less. raman is B. V. Raman's, about 1 degree 27 arcminutes less. Also: yukteshwar (Sri Yukteshwar's, about 1 degree 23 arcminutes less), jn_bhasin (J. N. Bhasin's, about 1 degree 6 arcminutes less), ushashashi (about 3 degrees 48 arcminutes less) and fagan_bradley (the Western sidereal zodiac, about 53 arcminutes more). true_chitra keeps the star Spica (Chitra) at exactly 180 degrees, so it follows the star itself; it is within about a minute of arc of Lahiri. The chosen ayanamsa is also used for the transits, sade sati and forecasts read against this chart.
nodebodyHow to calculate Rahu and Ketu, the lunar nodes (the two points where the Moon's orbit crosses the Sun's path). Use true for the actual position (the default) or mean for the averaged position.

Main response fields

  • recommended (array of objects): each item holds mukhi, graha, deity, wearing, selected_by, reasons, notes, title, reading.
  • dasha_lord (string)
  • scheme (object): holds provenance, table, note.
  • not_claimed (array of strings)
  • not_computed (array of strings)
  • as_of (string)
  • framing (object): holds title, text, language, detail.
  • not_a_guarantee (object): holds title, text, language, detail.
  • gaps (array)
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/remedies/rudraksha?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "recommended": [
    {
      "mukhi": 4,
      "graha": "Mercury",
      "deity": "Brahma",
      "wearing": {
        "day": "Wednesday",
        "thread": {
          "colors": [
            "green",
            "yellow"
          ]
        },
        "metal": "silver or gold",
        "beeja": "Om Braam Breem Braum Sah Budhaya Namah",
        "beeja_devanagari": "ॐ ब्रां ब्रीं ब्रौं सः बुधाय नमः",
        "recitations": 108,
        "title": "How to wear it",
        "text": [
          "Start on a Wednesday, after a bath. String the bead on green or yellow thread, or have it capped in silver or gold if you prefer. Before you put it on for the first time, recite the mantra of Mercury over it 108 times: Om Braam Breem Braum…",
          "Take it off to sleep if it gets in the way, and keep the thread clean."
        ],
        "language": "en",
        "detail": "standard"
      },
      "selected_by": [
        "ascendant_lord"
      ],
      "reasons": [
        {
          "basis": "ascendant_lord",
          "graha": "Mercury",
          "ascendant_sign": "Virgo",
          "text": [
            "Your rising sign is Virgo, and its ruler is Mercury. This bead is for the whole of life, because your rising sign does not change."
          ],
          "language": "en",
          "detail": "standard"
        }
      ],
      "notes": [
        "Mercury stands in the 12th house, a house of effort."
      ],
      "title": "Four-mukhi rudraksha",
      "reading": {
        "text": [
          "The four-mukhi bead is linked with Brahma, and its four faces stand for the four Vedas. Its planet is Mercury, which looks after speech, study, trade and clear thinking.",
          "Students and people who work with words or numbers often choose it. The bead is worn in the hope of clearer speech and a more orderly mind."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "mukhi": 5,
      "graha": "Jupiter",
      "deity": "Kalagni Rudra",
      "wearing": {
        "day": "Thursday",
        "thread": {
          "colors": [
            "yellow"
          ]
        },
        "metal": "silver or gold",
        "beeja": "Om Graam Greem Graum Sah Gurave Namah",
        "beeja_devanagari": "ॐ ग्रां ग्रीं ग्रौं सः गुरवे नमः",
        "recitations": 108,
        "title": "How to wear it",
        "text": [
          "Start on a Thursday, after a bath. String the bead on yellow thread, or have it capped in silver or gold if you prefer. Before you put it on for the first time, recite the mantra of Jupiter over it 108 times: Om Graam Greem Graum Sah…",
          "Take it off to sleep if it gets in the way, and keep the thread clean."
        ],
        "language": "en",
        "detail": "standard"
      },
      "selected_by": [
        "mahadasha_lord"
      ],
      "reasons": [
        {
          "basis": "mahadasha_lord",
          "graha": "Jupiter",
          "period": {
            "start": "2014-12-20T19:27:09.380502",
            "end": "2030-12-20T19:27:09.380502"
          },
          "text": [
            "You are in the main period of Jupiter, which runs from December 2014 to December 2030. This bead is for that period, and the choice changes when the next period begins."
          ],
          "language": "en",
          "detail": "standard"
        }
      ],
      "notes": [
        "Jupiter rules the 7th house. The old texts differ on whether to strengthen the lord of this house.",
        "Jupiter is already strong here (exalted). A stone adds least where the planet is already strongest."
      ],
      "title": "Five-mukhi rudraksha",
      "reading": {
        "text": [
          "The five-mukhi bead is linked with Kalagni Rudra, a fierce form of Shiva, and with Jupiter. Jupiter looks after wisdom, teachers, children and good advice.",
          "The five-mukhi is the most common bead, the plain bead of a prayer mala, and it is easy to find. People wear it in the hope of good judgment and a calmer way of making decisions."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "mukhi": 3,
      "graha": "Mars",
      "deity": "Agni",
      "wearing": {
        "day": "Tuesday",
        "thread": {
          "colors": [
            "red"
          ]
        },
        "metal": "silver or gold",
        "beeja": "Om Kraam Kreem Kraum Sah Bhaumaya Namah",
        "beeja_devanagari": "ॐ क्रां क्रीं क्रौं सः भौमाय नमः",
        "recitations": 108,
        "title": "How to wear it",
        "text": [
          "Start on a Tuesday, after a bath. String the bead on red thread, or have it capped in silver or gold if you prefer. Before you put it on for the first time, recite the mantra of Mars over it 108 times: Om Kraam Kreem Kraum Sah Bhaumaya…",
          "Take it off to sleep if it gets in the way, and keep the thread clean."
        ],
        "language": "en",
        "detail": "standard"
      },
      "selected_by": [
        "nakshatra_lord"
      ],
      "reasons": [
        {
          "basis": "nakshatra_lord",
          "graha": "Mars",
          "nakshatra": "Mrigashira",
          "text": [
            "You were born with the Moon in Mrigashira, a birth star ruled by Mars. Like your rising sign, this does not change."
          ],
          "language": "en",
          "detail": "standard"
        }
      ],
      "notes": [
        "Mars stands in the 8th house, a house of effort.",
        "Mars is already strong here (own sign). A stone adds least where the planet is already strongest."
      ],
      "title": "Three-mukhi rudraksha",
      "reading": {
        "text": [
          "The three-mukhi bead is linked with Agni, the god of fire, and with Mars. Mars looks after your drive, your courage and the energy to begin.",
          "The fire it stands for is the kind that clears away what is used up. People who want to start again after a setback often choose it. The bead is worn in the hope of steadier drive, not a hotter temper."
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "dasha_lord": "Jupiter",
  "scheme": {
    "provenance": "school",
    "table": [
      {
        "mukhi": 1,
        "graha": "Sun",
        "deity": "Shiva"
      },
      {
        "mukhi": 2,
        "graha": "Moon",
        "deity": "Ardhanarishvara"
      },
      {
        "mukhi": 3,
        "graha": "Mars",
        "deity": "Agni"
      }
    ],
    "note": "texts differ on which bead serves which graha. This is the commonly used scheme, one bead per graha in the classical order. It is the same table the period remedy reads, so the two cannot disagree."
  },
  "not_claimed": [
    "a cure or treatment for any illness; a health concern needs a doctor",
    "a guarantee of any outcome; a bead is a traditional support, not a promise",
    "a ranking of beads; no mukhi is said to be stronger than another"
  ],
  "not_computed": [
    "whether a particular bead is genuine or how many faces it truly has; that is a matter of the bead, not the chart",
    "beads of ten or more faces, and the joined forms such as Gauri Shankar. This scheme maps one bead to each of the nine grahas and no further"
  ],
  "as_of": "2026-10-01",
  "framing": {
    "title": "Your rudraksha",
    "text": [
      "A rudraksha is the dried seed of a tree linked with Shiva, worn as a bead. The natural lines that run down it are called its faces, or mukhi. Each number of faces is linked with one planet. Your chart points to a bead in up to three ways.…",
      "When two of these point to the same planet, the bead is listed once with both reasons. Texts do not all agree on which bead goes with which planet. The table used here is the common one. It gives one bead for each of the nine planets, from…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "not_a_guarantee": {
    "title": "Not a guarantee",
    "text": [
      "**A rudraksha is a traditional support, not a guarantee.** The bead is not a treatment for any illness. It does not replace a doctor, a lawyer or your own effort. Wear it as a reminder of what you are working on. Judge it by how you live,…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "gaps": [],
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference. Feature: Remedies.

Charity (daan) this chart points to, and why

POST /v1/remedies/charity

Returns what to give, to whom and on which day, in sets chosen from this chart, each with the reason it applies. Each entry has daan_items (things to give), give_to (who to give them to) and day. The list is the classical one for each planet: its grain, its color, its metal and the people it stands for. See rulebook RM-10 and RM-11.

How a set is chosen. Every remedy list picks its planets the same way, so the lists agree. dasha_lord: the planet whose mahadasha (main period) runs on as_of. sub_period: the planet whose antardasha (sub-period) runs on as_of, with starts, ends and the next sub-period. The first sub-period of a mahadasha is the same planet, so it is listed in not_applicable as same_lord. lagna_lord: the ruler of the rising sign, for life. sade_sati: Saturn, while a sade sati passage runs. manglik (Mars), kaalsarpa (Rahu and Ketu) and pitra (the Sun, with tithi: Amavasya, the new-moon day): only when /v1/dosha/all reports that dosha present. A set that does not apply is in not_applicable with why, and sade sati with the date it next starts.

Each set has entries, one per planet. A planet named by more than one set is listed under each with its own reason; grahas lists each planet once with the sets that name it. day is the planet's weekday. Rahu and Ketu rule no weekday, so their day carries day_review naming the other days sources give. Nothing here is a promise of a result: not_claimed says so, and not_a_guarantee says it in the reader's language.

Cost: Each successful request counts as 1 call toward your monthly calls.

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.
Optional inputs (9), with their defaults
NameInWhat it does
langqueryLanguage of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too.
detailqueryLength of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field.
as_ofqueryDate for the running mahadasha and sade sati, YYYY-MM-DD. Defaults to today. Set it if you need the same response on every call.
hourbodyHour of birth on the local clock at the birth place, from 0 to 23 (24-hour clock). Default 0.
minutebodyMinute of birth, from 0 to 59. Default 0.
secondbodySecond of birth, from 0 to 59. Default 0.
timezone_foldbodyOnly needed for a local time that happens twice, on the night the clocks go back. In the US since 2007, that is 1:00 to 1:59 AM on the first Sunday in November. 0 picks the first occurrence (before the change) and 1 the second. Without it, such a time is rejected, not guessed. A wrong guess would quietly move the chart by an hour. A local time that never happens, because the clocks jumped forward over it, is also rejected; check the birth time, or send the UTC offset that was in force.
ayanamsabodyThe ayanamsa: the offset between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). lahiri (the default) is the Lahiri, or Chitrapaksha, ayanamsa used by the Government of India. kp is the Krishnamurti ayanamsa used in KP astrology, about 6 arcminutes less. raman is B. V. Raman's, about 1 degree 27 arcminutes less. Also: yukteshwar (Sri Yukteshwar's, about 1 degree 23 arcminutes less), jn_bhasin (J. N. Bhasin's, about 1 degree 6 arcminutes less), ushashashi (about 3 degrees 48 arcminutes less) and fagan_bradley (the Western sidereal zodiac, about 53 arcminutes more). true_chitra keeps the star Spica (Chitra) at exactly 180 degrees, so it follows the star itself; it is within about a minute of arc of Lahiri. The chosen ayanamsa is also used for the transits, sade sati and forecasts read against this chart.
nodebodyHow to calculate Rahu and Ketu, the lunar nodes (the two points where the Moon's orbit crosses the Sun's path). Use true for the actual position (the default) or mean for the averaged position.

Main response fields

  • kind (string)
  • sets (array of objects): each item holds set, why, ends, entries, title, reading.
  • grahas (array of objects): each item holds graha, sets.
  • not_applicable (array of objects): each item holds set, why, next_starts, title, reading.
  • not_claimed (array of strings)
  • as_of (string)
  • framing (object): holds title, text, language, detail.
  • not_a_guarantee (object): holds title, text, language, detail.
  • gaps (array)
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/remedies/charity?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "kind": "charity",
  "sets": [
    {
      "set": "dasha_lord",
      "why": "running_mahadasha_lord",
      "ends": "2030-12-20",
      "entries": [
        {
          "graha": "Jupiter",
          "day": "Thursday",
          "daan_items": [
            "chana dal",
            "turmeric",
            "bananas"
          ],
          "give_to": [
            "teachers",
            "priests"
          ],
          "acts": [],
          "how": {
            "text": [
              "On Thursday, give chana dal, turmeric, bananas and yellow cloth to teachers or priests. Any one of these is enough."
            ],
            "language": "en",
            "detail": "standard"
          }
        }
      ],
      "title": "For your current period",
      "reading": {
        "text": [
          "You are in the main period (dasha) of Jupiter, which runs until December 2030. So this charity is for Jupiter."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "set": "sub_period",
      "why": "running_antardasha_lord",
      "within": "Jupiter",
      "starts": "2026-04-21",
      "ends": "2027-08-21",
      "next": {
        "graha": "Mars",
        "starts": "2027-08-21",
        "reading": {
          "text": [
            "After that, the sub-period of Mars starts on August 21, 2027, and its list takes over."
          ],
          "language": "en",
          "detail": "standard"
        }
      },
      "entries": [
        {
          "graha": "Moon",
          "day": "Monday",
          "daan_items": [
            "rice",
            "milk",
            "sugar"
          ],
          "give_to": [
            "mothers and older women"
          ],
          "acts": [],
          "how": {
            "text": [
              "On Monday, give rice, milk, sugar and white cloth to mothers and older women. Any one of these is enough."
            ],
            "language": "en",
            "detail": "standard"
          }
        }
      ],
      "title": "For your current sub-period",
      "reading": {
        "text": [
          "Inside your main period of Jupiter, you are now in the sub-period (antardasha) of Moon. It runs from April 21, 2026 to August 21, 2027. For this time, you can add this charity for Moon."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "set": "lagna_lord",
      "why": "ascendant_lord",
      "ascendant_sign": "Virgo",
      "entries": [
        {
          "graha": "Mercury",
          "day": "Wednesday",
          "daan_items": [
            "green moong",
            "green vegetables",
            "green cloth"
          ],
          "give_to": [
            "students",
            "young girls"
          ],
          "acts": [],
          "how": {
            "text": [
              "On Wednesday, give green moong, green vegetables and green cloth to students or young girls. Any one of these is enough."
            ],
            "language": "en",
            "detail": "standard"
          }
        }
      ],
      "title": "For your rising sign",
      "reading": {
        "text": [
          "Your rising sign (lagna) is Virgo, and its ruler is Mercury. This stays the same all your life, so this charity for Mercury suits you at any time."
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "grahas": [
    {
      "graha": "Jupiter",
      "sets": [
        "dasha_lord"
      ]
    },
    {
      "graha": "Moon",
      "sets": [
        "sub_period"
      ]
    },
    {
      "graha": "Mercury",
      "sets": [
        "lagna_lord"
      ]
    }
  ],
  "not_applicable": [
    {
      "set": "sade_sati",
      "why": "not_running",
      "next_starts": "2027-06-02",
      "title": "For sade sati",
      "reading": {
        "text": [
          "Sade sati is not running for you now. It next starts in June 2027."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "set": "kaalsarpa",
      "why": "not_present",
      "title": "For kaal sarp dosha",
      "reading": {
        "text": [
          "Your chart does not have this dosha, so nothing is listed for it."
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "not_claimed": [
    "a result from giving",
    "a replacement for medical, legal or other advice",
    "an amount: give what you can afford"
  ],
  "as_of": "2026-10-01",
  "framing": {
    "title": "Your charity (daan)",
    "text": [
      "Daan means giving to others as a way to honor a planet. What to give, to whom and on which day was picked from your own chart. It follows the planet whose period you are in now, the ruler of your rising sign, and any dosha (a hard spot in…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "not_a_guarantee": {
    "title": "Not a guarantee",
    "text": [
      "Giving is a practice of kindness and faith. It is not a promise of any result, and it does not replace advice from a doctor, a lawyer or any other expert. Give only what you can afford."
    ],
    "language": "en",
    "detail": "standard"
  },
  "gaps": [],
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference. Feature: Remedies.

Fasting (vrat) this chart points to, and why

POST /v1/remedies/fasting

Returns which weekday fasts to keep, in sets chosen from this chart, each with the reason it applies. A fast here is one simple meal on the planet's day (fast: one_meal); each entry has day, foods (what that meal can be) and no_salt (true where the fast is commonly kept without salt).

Every response carries caution, in the reader's language and length: skip or soften the fast when pregnant, unwell, older or on medicine, and ask a doctor first. Show it with the list. See rulebook RM-10 to RM-12.

How a set is chosen. Every remedy list picks its planets the same way, so the lists agree. dasha_lord: the planet whose mahadasha (main period) runs on as_of. sub_period: the planet whose antardasha (sub-period) runs on as_of, with starts, ends and the next sub-period. The first sub-period of a mahadasha is the same planet, so it is listed in not_applicable as same_lord. lagna_lord: the ruler of the rising sign, for life. sade_sati: Saturn, while a sade sati passage runs. manglik (Mars), kaalsarpa (Rahu and Ketu) and pitra (the Sun, with tithi: Amavasya, the new-moon day): only when /v1/dosha/all reports that dosha present. A set that does not apply is in not_applicable with why, and sade sati with the date it next starts.

Each set has entries, one per planet. A planet named by more than one set is listed under each with its own reason; grahas lists each planet once with the sets that name it. day is the planet's weekday. Rahu and Ketu rule no weekday, so their day carries day_review naming the other days sources give. Nothing here is a promise of a result: not_claimed says so, and not_a_guarantee says it in the reader's language.

Cost: Each successful request counts as 1 call toward your monthly calls.

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.
Optional inputs (9), with their defaults
NameInWhat it does
langqueryLanguage of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too.
detailqueryLength of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field.
as_ofqueryDate for the running mahadasha and sade sati, YYYY-MM-DD. Defaults to today. Set it if you need the same response on every call.
hourbodyHour of birth on the local clock at the birth place, from 0 to 23 (24-hour clock). Default 0.
minutebodyMinute of birth, from 0 to 59. Default 0.
secondbodySecond of birth, from 0 to 59. Default 0.
timezone_foldbodyOnly needed for a local time that happens twice, on the night the clocks go back. In the US since 2007, that is 1:00 to 1:59 AM on the first Sunday in November. 0 picks the first occurrence (before the change) and 1 the second. Without it, such a time is rejected, not guessed. A wrong guess would quietly move the chart by an hour. A local time that never happens, because the clocks jumped forward over it, is also rejected; check the birth time, or send the UTC offset that was in force.
ayanamsabodyThe ayanamsa: the offset between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). lahiri (the default) is the Lahiri, or Chitrapaksha, ayanamsa used by the Government of India. kp is the Krishnamurti ayanamsa used in KP astrology, about 6 arcminutes less. raman is B. V. Raman's, about 1 degree 27 arcminutes less. Also: yukteshwar (Sri Yukteshwar's, about 1 degree 23 arcminutes less), jn_bhasin (J. N. Bhasin's, about 1 degree 6 arcminutes less), ushashashi (about 3 degrees 48 arcminutes less) and fagan_bradley (the Western sidereal zodiac, about 53 arcminutes more). true_chitra keeps the star Spica (Chitra) at exactly 180 degrees, so it follows the star itself; it is within about a minute of arc of Lahiri. The chosen ayanamsa is also used for the transits, sade sati and forecasts read against this chart.
nodebodyHow to calculate Rahu and Ketu, the lunar nodes (the two points where the Moon's orbit crosses the Sun's path). Use true for the actual position (the default) or mean for the averaged position.

Main response fields

  • kind (string)
  • sets (array of objects): each item holds set, why, ends, entries, title, reading.
  • grahas (array of objects): each item holds graha, sets.
  • not_applicable (array of objects): each item holds set, why, next_starts, title, reading.
  • not_claimed (array of strings)
  • as_of (string)
  • framing (object): holds title, text, language, detail.
  • not_a_guarantee (object): holds title, text, language, detail.
  • caution (object): holds title, text, language, detail.
  • gaps (array)
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/remedies/fasting?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "kind": "fasting",
  "sets": [
    {
      "set": "dasha_lord",
      "why": "running_mahadasha_lord",
      "ends": "2030-12-20",
      "entries": [
        {
          "graha": "Jupiter",
          "day": "Thursday",
          "fast": "one_meal",
          "foods": [
            "chana dal",
            "bananas"
          ],
          "no_salt": true,
          "how": {
            "text": [
              "On Thursday, keep a fast for Jupiter. Eat just one simple meal that day, made from foods such as chana dal or bananas. Many people keep this fast without salt."
            ],
            "language": "en",
            "detail": "standard"
          }
        }
      ],
      "title": "For your current period",
      "reading": {
        "text": [
          "You are in the main period (dasha) of Jupiter, which runs until December 2030. So this fast is for Jupiter."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "set": "sub_period",
      "why": "running_antardasha_lord",
      "within": "Jupiter",
      "starts": "2026-04-21",
      "ends": "2027-08-21",
      "next": {
        "graha": "Mars",
        "starts": "2027-08-21",
        "reading": {
          "text": [
            "After that, the sub-period of Mars starts on August 21, 2027, and its list takes over."
          ],
          "language": "en",
          "detail": "standard"
        }
      },
      "entries": [
        {
          "graha": "Moon",
          "day": "Monday",
          "fast": "one_meal",
          "foods": [
            "rice",
            "milk",
            "curd"
          ],
          "no_salt": false,
          "how": {
            "text": [
              "On Monday, keep a fast for Moon. Eat just one simple meal that day, made from foods such as rice, milk or curd."
            ],
            "language": "en",
            "detail": "standard"
          }
        }
      ],
      "title": "For your current sub-period",
      "reading": {
        "text": [
          "Inside your main period of Jupiter, you are now in the sub-period (antardasha) of Moon. It runs from April 21, 2026 to August 21, 2027. For this time, you can add this fast for Moon."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "set": "lagna_lord",
      "why": "ascendant_lord",
      "ascendant_sign": "Virgo",
      "entries": [
        {
          "graha": "Mercury",
          "day": "Wednesday",
          "fast": "one_meal",
          "foods": [
            "green moong",
            "green vegetables"
          ],
          "no_salt": false,
          "how": {
            "text": [
              "On Wednesday, keep a fast for Mercury. Eat just one simple meal that day, made from foods such as green moong or green vegetables."
            ],
            "language": "en",
            "detail": "standard"
          }
        }
      ],
      "title": "For your rising sign",
      "reading": {
        "text": [
          "Your rising sign (lagna) is Virgo, and its ruler is Mercury. This stays the same all your life, so this fast for Mercury suits you at any time."
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "grahas": [
    {
      "graha": "Jupiter",
      "sets": [
        "dasha_lord"
      ]
    },
    {
      "graha": "Moon",
      "sets": [
        "sub_period"
      ]
    },
    {
      "graha": "Mercury",
      "sets": [
        "lagna_lord"
      ]
    }
  ],
  "not_applicable": [
    {
      "set": "sade_sati",
      "why": "not_running",
      "next_starts": "2027-06-02",
      "title": "For sade sati",
      "reading": {
        "text": [
          "Sade sati is not running for you now. It next starts in June 2027."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "set": "kaalsarpa",
      "why": "not_present",
      "title": "For kaal sarp dosha",
      "reading": {
        "text": [
          "Your chart does not have this dosha, so nothing is listed for it."
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "not_claimed": [
    "a result from fasting",
    "a replacement for medical, legal or other advice",
    "that a fast suits everyone: see `caution`"
  ],
  "as_of": "2026-10-01",
  "framing": {
    "title": "Your fasts (vrat)",
    "text": [
      "A vrat is a fast kept on one day of the week to honor a planet. On that day you eat one simple meal. The fasts here were picked from your own chart. They follow the planet whose period you are in now, the ruler of your rising sign, and any…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "not_a_guarantee": {
    "title": "Not a guarantee",
    "text": [
      "A fast is a practice of faith and self-control. It is not a promise of any result, and it does not replace advice from a doctor, a lawyer or any other expert."
    ],
    "language": "en",
    "detail": "standard"
  },
  "caution": {
    "title": "Before you fast",
    "text": [
      "Skip the fast, or make it lighter, if you are pregnant, unwell, older, or take any medicine. Ask your doctor before you start. A small meal or some fruit on the day still keeps the spirit of the fast."
    ],
    "language": "en",
    "detail": "standard"
  },
  "gaps": [],
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference. Feature: Remedies.

Life gemstone

POST /v1/reading/section/topic:remedy-life-gemstone

The gemstone for life, chosen from the ascendant lord, with why and how to wear it.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-life-gemstone?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-life-gemstone",
    "group": "topic",
    "title": "Remedies: Life gemstone"
  },
  "blocks": [
    {
      "id": "topic:remedy-life-gemstone",
      "title": "Remedies: Life gemstone",
      "family": "remedies",
      "score": null,
      "text": [
        "**Emerald is Mercury's stone.** Mercury rules speech, numbers, trade, learning and your hands. So you wear this stone when those skills feel blocked. It suits anyone whose living depends on being understood: people who write, teach, sell,…",
        "Emerald is set in gold and worn on the little finger. Start on a Wednesday, Mercury's day, in the morning during the waxing fortnight, when the Moon is growing. Three to six carats is usual, and a clear stone matters more than a big one.…",
        "People notice it in how easily things come out, not in how clever they are. The sentence comes faster, you check the figure before sending it, and the deal doesn't stall. Mercury is a neutral planet and takes on the color of whatever it…"
      ],
      "language": "en",
      "detail": "standard",
      "keyed_on": [
        "Mercury"
      ],
      "selection": {
        "selected_by": "ascendant lord",
        "ascendant": "Virgo",
        "graha": "Mercury",
        "stone": "Emerald",
        "sanskrit": "Panna",
        "substitutes": [
          "Green tourmaline",
          "Peridot",
          "Green onyx"
        ],
        "metal": "gold",
        "finger": "little",
        "day": "Wednesday",
        "notes": [
          "Mercury stands in the 12th house, a house of effort."
        ],
        "note": "the life gemstone is read from the ascendant lord and does not change with the dasha. It is the one remedy in this list that is fixed for life."
      }
    }
  ],
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

Lucky gemstone

POST /v1/reading/section/topic:remedy-lucky-gemstone

The gemstone for the period you are in now, chosen from the running mahadasha lord. Add as_of (YYYY-MM-DD) to read it for another date.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-lucky-gemstone?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-lucky-gemstone",
    "group": "topic",
    "title": "Remedies: Lucky gemstone"
  },
  "blocks": [
    {
      "id": "topic:remedy-lucky-gemstone",
      "title": "Remedies: Lucky gemstone",
      "family": "remedies",
      "score": null,
      "text": [
        "**Yellow sapphire is Jupiter's stone.** Jupiter stands for teaching, advice, children and your guru (spiritual teacher). Jupiter also stands for the kind of luck that comes when someone decides to help you. Yellow sapphire is the most…",
        "The stone is set in gold and worn on the index finger. Start on a Thursday, Jupiter's day, in the morning during the waxing fortnight. Five carats or more is the usual advice. Yellow topaz and citrine are the substitutes, and they cost far…",
        "People describe chances that come through other people rather than effort: an introduction, an offer, a teacher. In a woman's chart, tradition also links it to marriage, because Jupiter is the karaka (significator) for the husband. Yellow…"
      ],
      "language": "en",
      "detail": "standard",
      "keyed_on": [
        "Jupiter"
      ],
      "selection": {
        "selected_by": "running mahadasha lord",
        "graha": "Jupiter",
        "stone": "Yellow sapphire",
        "sanskrit": "Pukhraj",
        "substitutes": [
          "Yellow topaz",
          "Citrine"
        ],
        "metal": "gold",
        "finger": "index",
        "day": "Thursday",
        "notes": [
          "Jupiter rules the 7th house. The old texts differ on whether to strengthen the lord of this house.",
          "Jupiter is already strong here (exalted). A stone adds least where the planet is already strongest."
        ],
        "same_as_life_gemstone": false
      }
    }
  ],
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

Rudraksha reading

POST /v1/reading/section/topic:remedy-rudraksha

The rudraksha bead for the period you are in now, as a written reading. For the beads and their reasons as data, use the rudraksha endpoint above. Add as_of (YYYY-MM-DD) to read it for another date.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-rudraksha?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-rudraksha",
    "group": "topic",
    "title": "Remedies: Rudraksha"
  },
  "blocks": [
    {
      "id": "topic:remedy-rudraksha",
      "title": "Remedies: Rudraksha",
      "family": "remedies",
      "score": null,
      "text": [
        "**The five-mukhi (five-faced) rudraksha is worn for Jupiter,** the planet of wisdom, teachers and good advice. This bead is the most common rudraksha there is: the plain bead in every mala (a string of prayer beads). Its five faces, the…",
        "You wear it at the throat on yellow thread, or as a mala of 108 beads. The mala is for japa (repeating a mantra on the beads). Start on a Thursday morning. Because it suits everyone, it is also the bead used when the chart isn't known or…",
        "The bead is given during a Jupiter period and when you lack guidance. Tradition also gives it for trouble with children or teachers, and as general support in any chart. The bead is linked with calm rather than growth. The clarity it…"
      ],
      "language": "en",
      "detail": "standard",
      "keyed_on": [
        "Jupiter"
      ],
      "selection": {
        "selected_by": "running mahadasha lord",
        "graha": "Jupiter",
        "mukhi": 5,
        "deity": "Kalagni Rudra"
      }
    }
  ],
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

Lucky mantra

POST /v1/reading/section/topic:remedy-lucky-mantra

The beej (seed) mantra of the running mahadasha lord, with its japa count (how many times to say it) and its deity. Add as_of (YYYY-MM-DD) to read it for another date.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-lucky-mantra?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-lucky-mantra",
    "group": "topic",
    "title": "Remedies: Lucky mantra"
  },
  "blocks": [
    {
      "id": "topic:remedy-lucky-mantra",
      "title": "Remedies: Lucky mantra",
      "family": "remedies",
      "score": null,
      "text": [
        "Jupiter's beeja (seed-syllable) mantra is Om Graam Greem Graum Sah Gurave Namah. Jupiter is the planet of teachers, children, advice and the help that comes through other people. A full anushthana, the complete course, is 19,000…",
        "Say it on Thursday, in the morning, facing north-east. The Guru Gayatri, a Gayatri verse for Jupiter, and the Vishnu Sahasranama both work as well. The charity form is giving away turmeric, chana dal and yellow cloth on a Thursday.…",
        "The mantra is given during a Jupiter period, for trouble with children, and when you lack good advice or direction. In a woman's chart, it is also given for marriage matters. Tradition also gives it when Jupiter is debilitated (at its…"
      ],
      "language": "en",
      "detail": "standard",
      "keyed_on": [
        "Jupiter"
      ],
      "selection": {
        "selected_by": "running mahadasha lord",
        "graha": "Jupiter",
        "beeja": "Om Graam Greem Graum Sah Gurave Namah",
        "japa": 19000,
        "deity": "Brihaspati"
      }
    }
  ],
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

Havan and puja

POST /v1/reading/section/topic:remedy-havan-puja

The havan (fire ritual) and puja that suit the running mahadasha lord. Add as_of (YYYY-MM-DD) to read it for another date.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-havan-puja?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-havan-puja",
    "group": "topic",
    "title": "Remedies: Havan and puja"
  },
  "blocks": [
    {
      "id": "topic:remedy-havan-puja",
      "title": "Remedies: Havan and puja",
      "family": "remedies",
      "score": null,
      "text": [
        "A havan means tending a small sacred fire and feeding it offerings, each given with a line of mantra. Guru havan, for Jupiter, the planet of teachers, children and wisdom, is done on a Thursday morning, facing north-east. The samidha (the…",
        "A household havan is 108 offerings, and the formal one is 1,900. Say the Guru Gayatri, a Gayatri verse for Jupiter, with it. The charity form is giving away turmeric, yellow cloth and chana on a Thursday. **For Jupiter, tradition rates…",
        "Guru havan is done at the start of a Jupiter period and before a marriage. People also do it when a child is born and before starting study. Jupiter debilitated (at its weakest) in Capricorn calls for it too. Jupiter rules what a family…"
      ],
      "language": "en",
      "detail": "standard",
      "keyed_on": [
        "Jupiter"
      ],
      "selection": {
        "selected_by": "running mahadasha lord",
        "graha": "Jupiter",
        "day": "Thursday",
        "samidha": "pippala",
        "offering": "chana dal, turmeric, yellow flowers"
      }
    }
  ],
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

General remedies

POST /v1/reading/section/topic:remedy-general

Everyday remedies for the period you are in now, chosen from the running mahadasha lord. Add as_of (YYYY-MM-DD) to read it for another date.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-general?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-general",
    "group": "topic",
    "title": "Remedies: General remedies"
  },
  "blocks": [
    {
      "id": "topic:remedy-general",
      "title": "Remedies: General remedies",
      "family": "remedies",
      "score": null,
      "text": [
        "A Jupiter period is the stretch of your planetary timeline (dasha) that Jupiter governs. **In these years, doors are opened by people more than by effort.** So the general remedies are all about being someone worth helping. Find a teacher…",
        "Teach someone without charging for it. For Jupiter, the texts rank this above every other remedy, above the gemstone and the fire ritual. For charity, give away turmeric, chana dal, yellow cloth and books on a Thursday, Jupiter's day.",
        "Pay attention to your children, your elders and the beliefs you were raised with. Jupiter periods tend to bring all three back up, whether or not you still hold those beliefs. The thing to watch here is growing without limits. This period…"
      ],
      "language": "en",
      "detail": "standard",
      "keyed_on": [
        "Jupiter"
      ],
      "selection": {
        "selected_by": "running mahadasha lord",
        "graha": "Jupiter"
      }
    }
  ],
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

Sade sati remedies

POST /v1/reading/section/topic:remedy-sadesati

Remedies for sade sati, Saturn's 7.5-year transit around your Moon sign. An empty blocks list means it does not apply to this chart. Add as_of (YYYY-MM-DD) to read it for another date.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-sadesati?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-sadesati",
    "group": "topic",
    "title": "Remedies: Sade sati remedies"
  },
  "blocks": [],
  "gaps": [
    {
      "id": "topic:remedy-sadesati",
      "family": "remedies",
      "title": "Remedies: Sade sati remedies",
      "not_applicable": true,
      "status": "upcoming",
      "reason": "this does not begin until 2027-06-02; the text is written, but it is not about this chart today",
      "applies": {
        "starts": "2027-06-02T19:58:14",
        "ends": "2034-07-12T18:52:55"
      }
    }
  ],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

Kaal sarp remedies

POST /v1/reading/section/topic:remedy-kaal-sarp

Remedies for kaal sarp dosha, when all seven planets from the Sun to Saturn sit on one side of Rahu and Ketu. An empty blocks list means it does not apply to this chart.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-kaal-sarp?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-kaal-sarp",
    "group": "topic",
    "title": "Remedies: Kaal sarp remedies"
  },
  "blocks": [],
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

Pitra dosha remedies

POST /v1/reading/section/topic:remedy-pitra-dosha

Remedies for pitra dosha, a duty to your ancestors read from the ninth house.

Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.

Every reading section id on the Sections and IDs page

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.

Main response fields

  • section (object): holds id, group, title.
  • blocks (array of objects): each item holds id, title, family, score, text, language, detail, graha, attribute, themes.
  • gaps (array)
  • language (string)
  • detail (string)
  • fell_back_to_en (boolean)
  • in_short (object): holds outcome, lines, basis.
  • tendency (object): holds graha, house, verdict, leans, counts, supports, strains, noted, not_evaluated, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-pitra-dosha?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "section": {
    "id": "topic:remedy-pitra-dosha",
    "group": "topic",
    "title": "Remedies: Pitra dosha remedies"
  },
  "blocks": [
    {
      "id": "topic:remedy-pitra-dosha",
      "title": "Remedies: Pitra dosha remedies",
      "family": "remedies",
      "score": null,
      "text": [
        "Pitra dosha (a duty to your ancestors) is read from trouble to the ninth house or to its ruling planet. The ninth house covers your father and ancestors. The trouble most often comes from the Sun, Rahu or Ketu. **It points to an unsettled…",
        "The main observance is shraddha, the rite for the dead, done during Pitru Paksha. Pitru Paksha is the waning fortnight just before the Navaratri festival, around September or October. Shraddha is done for three generations of your father's…",
        "The everyday forms are these: feeding crows and dogs, feeding brahmins or the poor on Amavasya, and giving away black sesame and water. Beyond the ritual, tradition asks you to look after the living elders of that line. It also asks you to…"
      ],
      "language": "en",
      "detail": "standard",
      "keyed_on": [],
      "selection": {
        "dosha": "pitra",
        "rule": "Sun, Rahu or Ketu afflicting the 9th house or its lord, or the 9th lord placed in a dusthana",
        "present": true,
        "ninth_lord": "Venus",
        "triggers": [
          {
            "graha": "Ketu",
            "how": "conjunct the 9th lord (Venus)",
            "cause": "ketu-with-9th-lord",
            "house": 11
          }
        ],
        "houses": [
          11
        ]
      }
    }
  ],
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference.

How we check the numbers

Every answer here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test accuracy.

Terms in this group