POST/api/astro/panchang_element_birth_effect/1 credit

Birth panchanga effects

The limbs of the panchanga — weekday, tithi, karana, yoga and fortnight, plus the planetary hora — each carry a classical character reading for a person born under them. This endpoint is the lookup table for those readings. It is pure reference text: nothing is computed, and no date, time or place is sent. You establish the person's birth tithi, weekday and so on elsewhere (from /api/astro/panchanga/, say) and pass the names in to get the paragraph that goes with each. The six lookup keys are get_vaara_during_birth, get_birth_tithi_effects, get_birth_karana_effects, get_birth_panchang_yoga_effects, get_birth_paksha_effects and get_birth_hora_result, each taking a request field of the matching name. Every accepted value is a lowercase transliteration and the exact spelling matters — 'shula' not 'shoola', 'priti' not 'preeti' — and the hora is named by the Sanskrit planet (surya, chandra, mangala…) rather than by the weekday. The six get_all_*_keys helpers return the accepted lists, and get_all_keys_summary returns all six at once; use one of those rather than hard-coding the vocabulary. An unrecognised value does not error: it returns HTTP 200 with a string listing the valid options.

https://yogataraapi.prahlad.app/api/astro/panchang_element_birth_effect/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
keys	array	required	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.
hora	string	optional	`suryachandramangalabudhabrihaspatishukrashani` An unknown value returns the string "Invalid hora: <x>. Available options: [...]" with HTTP 200 rather than an error status; the endpoint also exposes a companion key 'get_all_hora_keys' that returns this exact list at runtime. Watch the transliteration style: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (not shoola/preeti/indra), and hora values are the Sanskrit planet names (surya/chandra/mangala/budha/brihaspati/shukra/shani), not English weekday or planet names.
karana	string	optional	`bavabalavakaulavataitilagaravanijavishtishakunichatushpadanagakimstughna` An unknown value returns the string "Invalid karana: <x>. Available options: [...]" with HTTP 200 rather than an error status; the endpoint also exposes a companion key 'get_all_karana_keys' that returns this exact list at runtime. Watch the transliteration style: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (not shoola/preeti/indra), and hora values are the Sanskrit planet names (surya/chandra/mangala/budha/brihaspati/shukra/shani), not English weekday or planet names.
paksha	string	optional	`shuklakrishna` An unknown value returns the string "Invalid paksha: <x>. Available options: [...]" with HTTP 200 rather than an error status; the endpoint also exposes a companion key 'get_all_paksha_keys' that returns this exact list at runtime. Watch the transliteration style: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (not shoola/preeti/indra), and hora values are the Sanskrit planet names (surya/chandra/mangala/budha/brihaspati/shukra/shani), not English weekday or planet names.
tithi	string	optional	`pratipadadvitiyatritiyachaturthipanchamishashthisaptamiashtaminavamidashamiekadashidvadashi` An unknown value returns the string "Invalid tithi: <x>. Available options: [...]" with HTTP 200 rather than an error status; the endpoint also exposes a companion key 'get_all_tithi_keys' that returns this exact list at runtime. Watch the transliteration style: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (not shoola/preeti/indra), and hora values are the Sanskrit planet names (surya/chandra/mangala/budha/brihaspati/shukra/shani), not English weekday or planet names.
vaara	string	optional	`sundaymondaytuesdaywednesdaythursdayfridaysaturday` An unknown value returns the string "Invalid vaara: <x>. Available options: [...]" with HTTP 200 rather than an error status; the endpoint also exposes a companion key 'get_all_vaara_keys' that returns this exact list at runtime. Watch the transliteration style: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (not shoola/preeti/indra), and hora values are the Sanskrit planet names (surya/chandra/mangala/budha/brihaspati/shukra/shani), not English weekday or planet names.
yoga	string	optional	`vishkumbhapritiayushmansaubhagyashobhanaatigandasukarmadhritishulagandavriddhidhruva` An unknown value returns the string "Invalid yoga: <x>. Available options: [...]" with HTTP 200 rather than an error status; the endpoint also exposes a companion key 'get_all_yoga_keys' that returns this exact list at runtime. Watch the transliteration style: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (not shoola/preeti/indra), and hora values are the Sanskrit planet names (surya/chandra/mangala/budha/brihaspati/shukra/shani), not English weekday or planet names.

Available keys (13)

Ask for exactly the calculations you want by listing them in keys. An unknown key rejects the whole request, and you are charged 1 credit however many you ask for — so batch them.

Key	Extra fields needed	Description
get_all_hora_keys	—	The seven hora names this endpoint accepts, as a list of lowercase Sanskrit planet names.
get_all_karana_keys	—	The eleven karana names this endpoint accepts, as a list of lowercase strings.
get_all_keys_summary	—	Every accepted value for all six categories in one object, keyed vaara_keys, hora_keys, paksha_keys, tithi_keys, karana_keys and yoga_keys. One call instead of six.
get_all_paksha_keys	—	The two fortnight names this endpoint accepts, as a list of lowercase strings: shukla and krishna.
get_all_tithi_keys	—	The sixteen tithi names this endpoint accepts, as a list of lowercase strings. Use it to populate a picker rather than hard-coding the spellings.
get_all_vaara_keys	—	The seven weekday names this endpoint accepts, as a list of lowercase English day names.
get_all_yoga_keys	—	The twenty-seven Nityayoga names this endpoint accepts, as a list of lowercase strings.
get_birth_hora_result	hora	The reading for the planetary hora ruling the moment of birth. Takes hora as a lowercase Sanskrit planet name — surya, chandra, mangala, budha, brihaspati, shukra, shani — and returns a short paragraph of English prose.
get_birth_karana_effects	karana	The reading for the birth karana. Takes karana as one of the eleven lowercase names (bava, balava, kaulava, taitila, gara, vanija, vishti, shakuni, chatushpada, naga, kimstughna) and returns a paragraph of English prose.
get_birth_paksha_effects	paksha	The reading for being born in the bright or the dark fortnight. Takes paksha as 'shukla' or 'krishna' and returns a paragraph of English prose.
get_birth_panchang_yoga_effects	yoga	The reading for the Nityayoga in force at birth. Takes yoga as one of the twenty-seven lowercase names, vishkumbha through vaidhriti, and returns a paragraph of English prose.
get_birth_tithi_effects	tithi	The reading for the birth tithi. Takes tithi as one of sixteen lowercase names — pratipada through chaturdashi, plus purnima and amavasya — and returns a paragraph of English prose. One name covers that tithi in either fortnight.
get_vaara_during_birth	vaara	The character reading for being born on a given weekday. Takes vaara as a lowercase English day name and returns a paragraph of English prose. An unrecognised value returns a string listing the valid options, still with HTTP 200.

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/panchang_element_birth_effect/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_vaara_during_birth"],"vaara":"sunday","hora":"surya","paksha":"shukla","tithi":"pratipada","karana":"bava","yoga":"vishkumbha"}'

Response

{
  "data": {
    "get_vaara_during_birth": "Individuals born on Sunday typically possess a steady and determined nature with a fearless approach to life. They often have a naturally authoritative disposition and demonstrate skillfulness in their endeavors. These individuals tend to be honorable and maintain high standards of purity in their conduct. They may have a tendency toward bilious temperament and often exhibit leadership qualities with a noble bearing."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data, keyed by what you requested.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.