Getting started
Authentication Request and response Limits and credits Accuracy Parastro API · by Parasara Foundation
Vedic calculations, as a quiet JSON API. Birth charts, divisional charts, dasha periods, transits, the panchang and its timings, the Malayalam calendar and numerology. Computed with the Swiss Ephemeris and the Lahiri ayanamsa, the same engine behind Parastro. Calculations only: no predictions, no remedies.
24 endpoints JSON + SVG English & Malayalam
Authentication Every request carries your key:
Authorization: Bearer pk_live_…. Keys are issued by us;
write to sajith@tshaped.in for one.
Request and response GET with a query string. Success: { "status": "ok", "data": {…}, "meta": { "credits", "ms", "version" } }. Errors: { "status": "error", "code", "message" } with 400, 401, 403, 404 or 429.
Limits and credits Each key has requests per minute and credits per day. Every endpoint lists its credit weight below; the numbers follow Prokerala's so you can compare. A 429 carries Retry-After.
Accuracy Swiss Ephemeris (Moshier), Lahiri ayanamsa, true node for Rahu, whole-sign houses unless you choose otherwise. Dates from 1800 to 2200 for charts, 1900 to 2100 for the panchang. Results are deterministic.
Example request cURL
curl "https://parastro.com/api/v1/kundli?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141" \
-H "Authorization: Bearer pk_live_…" Common parameters: datetime is ISO 8601 with the offset of the place (the offset does the time-zone work for birth charts); coordinates is lat,lon; la is en or ml for names; day endpoints take date and tz.
Explore the API
Endpoint reference 24 endpoints Vedic chart Transits Kundli Matching Panchang Calendars Numerology
Vedic chart 8 endpoints
Planet positions 30 credits The nine grahas at birth: sidereal longitude, sign and degree, nakshatra and pada, retrograde, and the house from the ascendant and from the Moon.
Parameters for Planet positions Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns ascendant, planets[], ayanamsa
cURL example curl "https://parastro.com/api/v1/planet-position?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Birth details 50 credits Ascendant, Moon sign, Sun sign, birth star with its lord, deity, symbol, gana, nadi and yoni, the tithi, yoga and karana at birth, and the dasha balance.
Parameters for Birth details Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns ascendant, moon_sign, sun_sign, nakshatra, tithi, yoga, karana, dasha_balance_at_birth
cURL example curl "https://parastro.com/api/v1/birth-details?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Kundli 50 credits Everything for a birth chart page in one call: birth details, planet positions, the twelve houses with their planets, the current dasha chain and an SVG of the Rasi chart.
Parameters for Kundli Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English. chart enum: south | north (default south) Chart drawing style.
Returns birth_details, planets, houses, dasha, chart_svg
cURL example curl "https://parastro.com/api/v1/kundli?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Chart drawing 50 credits An SVG of any chart, South or North Indian, ready to place on a page.
Parameters for Chart drawing Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). d integer (default 1) Divisional chart number: 1, 2, 3, 4, 7, 9, 10, 12, 16, 20, 24, 27, 30, 40, 45 or 60. style enum: south | north (default south) South Indian (fixed signs) or North Indian (fixed houses). theme enum: dark | light | auto (default auto for json, dark for svg) Colours. auto follows the page's own colours when the SVG is placed inline. format enum: json | svg (default json) svg returns the image itself with an image/svg+xml content type.
Returns svg (string) or the SVG document
cURL example curl "https://parastro.com/api/v1/chart?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141&d=9&style=south" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Divisional chart positions 50 credits GET /v1/divisional-planet-position# Planets and ascendant in a divisional chart (Hora, Drekkana, Navamsa, Dasamsa and the rest), by the Parashari rules, with the twelve houses.
Parameters for Divisional chart positions Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English. drequired integer Varga number: 1, 2, 3, 4, 7, 9, 10, 12, 16, 20, 24, 27, 30, 40, 45 or 60.
Returns chart, chart_name, ascendant_rasi, planets[], houses[]
cURL example curl "https://parastro.com/api/v1/divisional-planet-position?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141&d=9" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Dasha periods 200 credits The full Vimshottari timeline from birth, with the maha, antar and pratyantar lords at a chosen instant.
Parameters for Dasha periods Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). at datetime The instant to evaluate. Defaults to now. levels integer (default 3) 1 for mahadashas only, 2 adds antardashas, 3 adds pratyantardashas.
Returns current, periods[]
cURL example curl "https://parastro.com/api/v1/dasha-periods?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141&levels=2" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
House positions 50 credits House cusps and the house each planet occupies, in the house system you choose.
Parameters for House positions Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English. house_system enum: whole_sign | equal | placidus | koch | sripati (default whole_sign) House system. Vedic practice uses whole sign; KP uses Placidus.
Returns house_system, houses[], planets[]
cURL example curl "https://parastro.com/api/v1/bhava-positions?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141&house_system=placidus" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Sudarshana chakra 100 credits GET /v1/sudarshana-chakra# The three rings: houses counted from the ascendant, from the Moon and from the Sun, each with its planets.
Parameters for Sudarshana chakra Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns lagna_chakra[], chandra_chakra[], surya_chakra[]
cURL example curl "https://parastro.com/api/v1/sudarshana-chakra?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Transits 3 endpoints
Transits 30 credits Where the planets are now, or at any instant, against the natal chart: sign, star, and the house from the ascendant and from the natal Moon.
Parameters for Transits Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English. at datetime The instant to evaluate. Defaults to now.
Returns at, natal_moon_rasi, natal_lagna_rasi, planets[]
cURL example curl "https://parastro.com/api/v1/transits?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Sade-Sati 30 credits Saturn's seven-and-a-half-year passages over the twelfth, first and second signs from the natal Moon, past and future, with the rising, peak and setting phases, plus the Dhaiya windows.
Parameters for Sade-Sati Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English. at datetime The instant to evaluate. Defaults to now.
Returns in_sade_sati, current, rounds[], dhaiya[]
cURL example curl "https://parastro.com/api/v1/sade-sati?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Chandrashtama days 200 credits The two or three days a month when the transiting Moon sits eighth from the natal Moon, with exact start and end times.
Parameters for Chandrashtama days Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English. from date Start of the range. Defaults to today. days integer (default 60) How many days to scan, up to 366.
Returns natal_moon_rasi, eighth_rasi, periods[]
cURL example curl "https://parastro.com/api/v1/chandrashtama?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141&days=90" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Kundli 1 endpoints
Yogas 40 credits Named planetary combinations: Gaja Kesari, Sunapha, Anapha, Durudhara, Kemadruma, Chandra-Mangala, Adhi, Sakata, Amala; Vesi, Vasi, Ubhayachari, Budha-Aditya; Ruchaka, Bhadra, Hamsa, Malavya, Sasa; Raja yogas of kendra and trikona lords, Dharma-Karmadhipati, Lakshmi, Saraswati, Chamara, Kahala, Parvata, Shankha, Trilochana, Bhaskara; Harsha, Sarala, Vimala; Neecha Bhanga; Dhana, Vasumati; Parivartana; Shubha and Papa Kartari, Lagnadhi, Mahabhagya; Guru-Chandala, Angarak, Grahan, Kala Sarpa; Nabhasa yogas. Each with present or not, the planets and houses, the rule applied and a line of meaning.
Parameters for Yogas Parameter Type Meaning datetimerequired datetime Birth date and time with the UTC offset of the birthplace, ISO 8601. coordinatesrequired coordinates Birthplace as "lat,lon" in decimal degrees (east and north positive). gender enum: male | female Optional; needed only for Mahabhagya. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns count, present[], all[], by_group
cURL example curl "https://parastro.com/api/v1/yogas?datetime=1983-03-21T23:00:00%2B05:30&coordinates=8.8932,76.6141" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Matching 1 endpoints
Kundali matching 50 credits Ashta Kuta out of 36: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot and Nadi, each with both sides' values and a one-line meaning, a verdict, the dosha flags and a Mangal dosha note for each person.
Parameters for Kundali matching Parameter Type Meaning girl_datetimerequired datetime The girl's birth date and time with offset. girl_coordinatesrequired coordinates The girl's birthplace as lat,lon. boy_datetimerequired datetime The boy's birth date and time with offset. boy_coordinatesrequired coordinates The boy's birthplace as lat,lon. girl_name string Optional, echoed back. boy_name string Optional, echoed back. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns girl, boy, kutas[], total, out_of, verdict, nadi_dosha, bhakoot_dosha, mangal_note
cURL example curl "https://parastro.com/api/v1/kundli-matching?girl_datetime=1990-06-14T07:30:00%2B05:30&girl_coordinates=9.9312,76.2673&boy_datetime=1983-03-21T23:00:00%2B05:30&boy_coordinates=8.8932,76.6141" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Panchang 8 endpoints
Panchang 10 credits The five limbs of the day at sunrise with the time each ends, sunrise, sunset, moonrise, moonset, the Moon and Sun signs, the Malayalam date and the day's observances.
Parameters for Panchang Parameter Type Meaning daterequired date Civil date, YYYY-MM-DD, in the zone given by tz. coordinatesrequired coordinates Place as "lat,lon". Sunrise, sunset and every timing are computed for this point. tz string (default Asia/Kolkata) IANA time zone of the place, so the day starts at its own midnight and times are shown in local clock as well as UTC. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns weekday, sunrise, sunset, tithi, nakshatra, yoga, karana, moon, sun, malayalam_date, occasions
cURL example curl "https://parastro.com/api/v1/panchang?date=2026-10-27&coordinates=9.9312,76.2673&tz=Asia/Kolkata" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Inauspicious periods 50 credits GET /v1/inauspicious-period# Rahu kalam, Yamaganda, Gulika kalam and Dur muhurtam for the day, in UTC and local clock.
Parameters for Inauspicious periods Parameter Type Meaning daterequired date Civil date, YYYY-MM-DD, in the zone given by tz. coordinatesrequired coordinates Place as "lat,lon". Sunrise, sunset and every timing are computed for this point. tz string (default Asia/Kolkata) IANA time zone of the place, so the day starts at its own midnight and times are shown in local clock as well as UTC. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns periods[]
cURL example curl "https://parastro.com/api/v1/inauspicious-period?date=2026-10-27&coordinates=9.9312,76.2673&tz=Asia/Kolkata" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Auspicious periods 50 credits GET /v1/auspicious-period# Brahma muhurta and Abhijit muhurta for the day.
Parameters for Auspicious periods Parameter Type Meaning daterequired date Civil date, YYYY-MM-DD, in the zone given by tz. coordinatesrequired coordinates Place as "lat,lon". Sunrise, sunset and every timing are computed for this point. tz string (default Asia/Kolkata) IANA time zone of the place, so the day starts at its own midnight and times are shown in local clock as well as UTC. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns periods[]
cURL example curl "https://parastro.com/api/v1/auspicious-period?date=2026-10-27&coordinates=9.9312,76.2673&tz=Asia/Kolkata" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Choghadiya 50 credits The eight day and eight night segments with their lords and qualities.
Parameters for Choghadiya Parameter Type Meaning daterequired date Civil date, YYYY-MM-DD, in the zone given by tz. coordinatesrequired coordinates Place as "lat,lon". Sunrise, sunset and every timing are computed for this point. tz string (default Asia/Kolkata) IANA time zone of the place, so the day starts at its own midnight and times are shown in local clock as well as UTC. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns day[], night[]
cURL example curl "https://parastro.com/api/v1/choghadiya?date=2026-10-27&coordinates=9.9312,76.2673&tz=Asia/Kolkata" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Hora 200 credits The twenty-four planetary hours from sunrise, twelve by day and twelve by night.
Parameters for Hora Parameter Type Meaning daterequired date Civil date, YYYY-MM-DD, in the zone given by tz. coordinatesrequired coordinates Place as "lat,lon". Sunrise, sunset and every timing are computed for this point. tz string (default Asia/Kolkata) IANA time zone of the place, so the day starts at its own midnight and times are shown in local clock as well as UTC. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns day[], night[]
cURL example curl "https://parastro.com/api/v1/hora?date=2026-10-27&coordinates=9.9312,76.2673&tz=Asia/Kolkata" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Tara bala 200 credits The day's tara for a birth star, with the full table of all 27 stars.
Parameters for Tara bala Parameter Type Meaning daterequired date Civil date, YYYY-MM-DD, in the zone given by tz. coordinatesrequired coordinates Place as "lat,lon". Sunrise, sunset and every timing are computed for this point. tz string (default Asia/Kolkata) IANA time zone of the place, so the day starts at its own midnight and times are shown in local clock as well as UTC. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English. birth_nakshatrarequired integer Birth star index 0 to 26 (Ashwini is 0).
Returns count, tara, favourable, all[]
cURL example curl "https://parastro.com/api/v1/tara-bala?date=2026-10-27&coordinates=9.9312,76.2673&tz=Asia/Kolkata&birth_nakshatra=4" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Chandra bala 200 credits The transiting Moon's house from the natal Moon and whether the day is supportive.
Parameters for Chandra bala Parameter Type Meaning daterequired date Civil date, YYYY-MM-DD, in the zone given by tz. coordinatesrequired coordinates Place as "lat,lon". Sunrise, sunset and every timing are computed for this point. tz string (default Asia/Kolkata) IANA time zone of the place, so the day starts at its own midnight and times are shown in local clock as well as UTC. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English. birth_moon_rasirequired integer Natal Moon sign index 0 to 11 (Mesha is 0).
Returns house_from_birth_moon, favourable, note
cURL example curl "https://parastro.com/api/v1/chandra-bala?date=2026-10-27&coordinates=9.9312,76.2673&tz=Asia/Kolkata&birth_moon_rasi=2" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Disha shool 100 credits The direction traditionally avoided for travel on each weekday, with the customary remedy.
Parameters for Disha shool Parameter Type Meaning daterequired date Civil date, YYYY-MM-DD, in the zone given by tz. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns avoid_direction, traditional_remedy
cURL example curl "https://parastro.com/api/v1/disha-shool?date=2026-10-27" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Calendars 1 endpoints
Malayalam calendar 2000 credits GET /v1/calendar/malayalam# Kollam-era dates both ways, and whole months with star, tithi and observances per day. Solar months by the Kerala rule.
Parameters for Malayalam calendar Parameter Type Meaning view enum: day | month | convert (default day) day converts a civil date; month lists a civil month; convert turns a Malayalam year, month (0 Medam to 11 Meenam) and day into a civil date. date date Civil date for the day view. year integer Civil year for month view; Kollam year for convert. month integer Civil month 1 to 12 for month view; Malayalam month 0 to 11 for convert. day integer Malayalam day for convert. coordinatesrequired coordinates Place as "lat,lon". Sunrise, sunset and every timing are computed for this point. tz string (default Asia/Kolkata) IANA time zone of the place, so the day starts at its own midnight and times are shown in local clock as well as UTC. la enum: en | ml (default en) Language for planet, sign, star, tithi and weekday names. Other fields stay English.
Returns malayalam, gregorian or days[]
cURL example curl "https://parastro.com/api/v1/calendar/malayalam?view=day&date=2026-10-27&coordinates=9.9312,76.2673" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Numerology 2 endpoints
Pythagorean numerology 100 credits GET /v1/numerology/pythagorean# Life path, expression, soul urge, personality, birthday, attitude, maturity, balance, hidden passion, karmic lessons, challenges, pinnacles and the personal and universal cycles, in one call.
Parameters for Pythagorean numerology Parameter Type Meaning namerequired string Full name as used. daterequired date Date of birth, YYYY-MM-DD.
Returns life_path, expression, soul_urge, … cycles
cURL example curl "https://parastro.com/api/v1/numerology/pythagorean?name=Meera%20Nair&date=1990-06-14" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗
Chaldean numerology 100 credits GET /v1/numerology/chaldean# Birth number, life path, the whole-name compound and single numbers, each name part, the initials code and the daily name number.
Parameters for Chaldean numerology Parameter Type Meaning namerequired string Full name as used. daterequired date Date of birth, YYYY-MM-DD.
Returns birth_number, life_path, whole_name, name_parts[]
cURL example curl "https://parastro.com/api/v1/numerology/chaldean?name=Meera%20Nair&date=1990-06-14" -H "Authorization: Bearer pk_live_…" Query string Edit the values, then try it
Try it↗