/api/astro/birth-panchanga-effects/1 creditBirth panchanga readings
What each of your birth panchanga elements is held to signify. Give the tithi, karana, yoga, vaara, hora and paksha you were born under and get the traditional reading for each in one call, instead of six calls with six key names nobody would guess. These are looked up by NAME, not computed from a chart: use /api/astro/panchang/ to find which tithi and karana a birth falls in, then pass the names here. /api/astro/panchanga-elements/ lists every spelling the lookup accepts.
https://yogataraapi.prahlad.app/api/astro/birth-panchanga-effects/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/jsonRequest fields
| Field | Type | Required | Notes |
|---|---|---|---|
| hora | string | optional | |
| karana | string | optional | |
| keys | array | optional | 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. |
| paksha | string | optional | |
| tithi | string | optional | |
| vaara | string | optional | |
| yoga | string | optional |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/birth-panchanga-effects/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tithi":"pratipada","karana":"bava","yoga":"vishkumbha","vaara":"sunday","hora":"surya","paksha":"shukla"}'Response
{
"data": {
"elements": [
{
"element": "tithi",
"is": "Lunar day",
"value": "pratipada",
"effect": "These individuals face critical early life periods but if they navigate these successfully, they develop remarkable strength and luminosity. They tend to be highly enterprising, righteous, and virtuous in their conduct."
},
{
"element": "karana",
"is": "Half of a lunar day",
"value": "bava",
"effect": "Individuals who may have strong desires but are charitable, wealthy, and happy. They often hold leadership positions and may work with children or in youthful endeavors, displaying courage."
},
{
"element": "yoga",
"is": "Sun-Moon combination",
"value": "vishkumbha",
"effect": "Though traditionally considered challenging for longevity, this yoga brings lovely appearance and fondness for family, home, and spouse. These individuals are typically wealthy, skillful in undertakings, and victorious over enemies. They maintain good physical appearance, enjoy independence, and are generally fortunate with family-oriented nature and leadership skills."
},
{
"element": "vaara",
"is": "Weekday",
"value": "sunday",
"effect": "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."
},
{
"element": "hora",
"is": "Planetary hour",
"value": "surya",
"effect": "Periods of dedicated effort and perseverance, with experiences that build character through challenges."
},
{
"element": "paksha",
"is": "Lunar fortnight",
"value": "shukla",
"effect": "Individuals born during the bright half of the lunar month are typically blessed with longevity and strong family connections. They often become protectors and supporters of many people, displaying charitable and friendly natures. These individuals tend to be honorable and may experience influence from their spouse. They are usually blessed with children and material wealth, following righteous paths and showing mercy to others."
}
]
},
"status": 200,
"is_error": false,
"message": "successful"
}Captured from a real call using the exact request above. Results sit under data.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.