Field
year
Type
integer
Required
Yes
Description
Birth year.
Back to Docs
Yoga Detection
Yoga Detection
POST
/api/v2/vedic/yogasEvaluate the V2 classical yoga catalog with active and inactive rules, strength grading, evidence, summary rollups, and Sade Sati context.
Authentication: send x-api-key.
Full URL
https://api.freeastroapi.com/api/v2/vedic/yogasSafe retries with Idempotency-Key
Authenticated, billable astrology POST requests accept the optional header Idempotency-Key: <client-generated unique operation key>. Reuse the same key only when retrying the exact same method, path, query string, and JSON body after a timeout or network failure.
A completed replay returns the first response with Idempotency-Replayed: true, does not rerun the calculation, and does not consume extra quota. Keys are retained for about 24 hours.
Reusing a key with a changed request returns 409 idempotency_key_reused. A duplicate while the first request is still running returns 409 request_in_progress with Retry-After.
What It Returns
An evaluated catalog of supported classical yogas and doshas. Each yoga row includes stable id, name, type, category, active state, strength when active, involved planets, houses, and structured evidence.
Example Request
curl -X POST "https://api.freeastroapi.com/api/v2/vedic/yogas" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"year": 1997,
"month": 9,
"day": 22,
"hour": 23,
"minute": 25,
"city": "Mumbai",
"lat": 19.391928,
"lng": 72.839732,
"tz_str": "Asia/Kolkata",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean"
}'Request Parameters
Provide either city or both lat and lng. Coordinates are recommended for stable production results.
Field
month
Type
integer
Required
Yes
Description
Birth month (1-12).
Field
day
Type
integer
Required
Yes
Description
Birth day.
Field
hour
Type
integer
Required
Yes
Description
Birth hour (0-23).
Field
minute
Type
integer
Required
Yes
Description
Birth minute (0-59).
Field
city
Type
string
Required
No
Description
Birth city. Optional when lat/lng are provided.
Field
lat
Type
float
Required
No
Description
Birth latitude. Recommended for production.
Field
lng
Type
float
Required
No
Description
Birth longitude. Recommended for production.
Field
tz_str
Type
string
Required
No
Description
Optional timezone override such as Asia/Kolkata, Europe/London, AUTO, or LMT. Defaults to AUTO when omitted.
Field
ayanamsha
Type
string
Required
No
Description
Vedic ayanamsha. Default is lahiri.
Field
house_system
Type
string
Required
No
Description
House system. Default is whole_sign.
Field
node_type
Type
string
Required
No
Description
Lunar node type: mean or true.
Response Shape
Field
yogas
Type
array
Required
n/a
Description
Evaluated active and inactive yoga catalog with evidence and strength.
Field
sade_sati
Type
object
Required
n/a
Description
Top-level Sade Sati context.
Field
summary
Type
object
Required
n/a
Description
Counts by active state, category, and type.
Field
metadata
Type
object
Required
n/a
Description
Endpoint version, ruleset, calculation settings, and evaluated rule ids.
Real Request Example
This request was captured from the live production endpoint and is the same payload used in the code tabs.
{
"year": 1997,
"month": 9,
"day": 22,
"hour": 23,
"minute": 25,
"city": "Mumbai",
"lat": 19.391928,
"lng": 72.839732,
"tz_str": "Asia/Kolkata",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean"
}Real Response Example
This is a real production response for the example payload. Large arrays are intentionally shown as returned by the API.
V2
{
"yogas": [
{
"id": "manglik_dosha",
"name": "Manglik Dosha",
"type": "dosha",
"category": "Affliction",
"active": true,
"description": "Mars in 1st, 4th, 7th, 8th, or 12th from Lagna or Moon.",
"planets": [
"Mars",
"Moon"
],
"houses_involved": [
7
],
"strength": "Strong",
"evidence": [
{
"kind": "house_relation",
"message": "Mars is 7 from Lagna."
},
{
"kind": "house_relation",
"message": "Mars is 7 from Moon."
}
]
},
{
"id": "kala_sarpa_yoga",
"name": "Kala Sarpa Yoga",
"type": "dosha",
"category": "Affliction",
"active": false,
"description": "All seven classical planets contained within one nodal arc between Rahu and Ketu.",
"planets": [
"Sun",
"Moon",
"Mars",
"Mercury",
"Jupiter",
"Venus",
"Saturn",
"Rahu",
"Ketu"
],
"houses_involved": [
4,
10
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "Classical planets are split across both nodal arcs."
}
]
},
{
"id": "gajakesari_yoga",
"name": "Gajakesari Yoga",
"type": "auspicious",
"category": "Grace & Reputation",
"active": false,
"description": "Jupiter in a kendra from the Moon.",
"planets": [
"Moon",
"Jupiter"
],
"houses_involved": [
1,
9
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "Jupiter is not in a kendra from the Moon."
}
]
},
{
"id": "budha_aditya_yoga",
"name": "Budha-Aditya Yoga",
"type": "auspicious",
"category": "Intellect",
"active": false,
"description": "Sun and Mercury occupy the same sign.",
"planets": [
"Sun",
"Mercury"
],
"houses_involved": [
4,
5
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "Sun and Mercury are not in the same sign."
}
]
},
{
"id": "chandra_mangala_yoga",
"name": "Chandra-Mangala Yoga",
"type": "dhana_yoga",
"category": "Wealth",
"active": true,
"description": "Moon and Mars are in conjunction or mutual 7th-sign aspect.",
"planets": [
"Moon",
"Mars"
],
"houses_involved": [
1,
7
],
"strength": "Medium",
"evidence": [
{
"kind": "mutual_aspect",
"message": "Moon and Mars are in mutual 7th-sign aspect."
},
{
"kind": "weakening_flag",
"message": "Moon is afflicted by a classical malefic."
}
]
},
{
"id": "adhi_yoga",
"name": "Adhi Yoga",
"type": "raj_yoga",
"category": "Power",
"active": true,
"description": "Benefics occupy the 6th, 7th, or 8th from the Moon.",
"planets": [
"Moon",
"Venus"
],
"houses_involved": [
1,
6
],
"strength": "Strong",
"evidence": [
{
"kind": "house_relation",
"message": "Venus is 6 from the Moon."
}
]
},
{
"id": "saraswati_yoga",
"name": "Saraswati Yoga",
"type": "auspicious",
"category": "Learning",
"active": false,
"description": "Mercury, Jupiter, and Venus are well placed from Lagna or Moon, with Jupiter dignified.",
"planets": [
"Mercury",
"Jupiter",
"Venus"
],
"houses_involved": [
4,
6,
9
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "Mercury, Jupiter, and Venus are not all well placed from Lagna or Moon with Jupiter dignified."
}
]
},
{
"id": "lakshmi_yoga",
"name": "Lakshmi Yoga",
"type": "dhana_yoga",
"category": "Fortune",
"active": false,
"description": "A strong 9th lord is related to a strong Lagna lord, or the 10th and 11th lords conjoin in the AstroSage article variant.",
"planets": [
"Jupiter",
"Saturn",
"Venus"
],
"houses_involved": [
1,
9,
10,
11
],
"strength": null,
"evidence": [
{
"kind": "strong_lord",
"message": "Lagna lord Venus is strong in Libra."
},
{
"kind": "missing_condition",
"message": "The Lagna/9th lord rule is absent and the 10th/11th lords are not conjoined."
}
]
},
{
"id": "ruchaka_yoga",
"name": "Ruchaka Yoga",
"type": "raj_yoga",
"category": "Panch Mahapurusha",
"active": true,
"description": "Mars in own or exalted sign in a kendra from Lagna.",
"planets": [
"Mars"
],
"houses_involved": [
7
],
"strength": "Strong",
"evidence": [
{
"kind": "dignity",
"message": "Mars is own in Scorpio."
},
{
"kind": "house_relation",
"message": "Mars is in kendra house 7."
}
]
},
{
"id": "bhadra_yoga",
"name": "Bhadra Yoga",
"type": "raj_yoga",
"category": "Panch Mahapurusha",
"active": false,
"description": "Mercury in own or exalted sign in a kendra from Lagna.",
"planets": [
"Mercury"
],
"houses_involved": [
4
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "Mercury is not in own/exalted sign in a kendra from Lagna."
}
]
},
{
"id": "hamsa_yoga",
"name": "Hamsa Yoga",
"type": "raj_yoga",
"category": "Panch Mahapurusha",
"active": false,
"description": "Jupiter in own or exalted sign in a kendra from Lagna.",
"planets": [
"Jupiter"
],
"houses_involved": [
9
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "Jupiter is not in own/exalted sign in a kendra from Lagna."
}
]
},
{
"id": "malavya_yoga",
"name": "Malavya Yoga",
"type": "raj_yoga",
"category": "Panch Mahapurusha",
"active": false,
"description": "Venus in own or exalted sign in a kendra from Lagna.",
"planets": [
"Venus"
],
"houses_involved": [
6
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "Venus is not in own/exalted sign in a kendra from Lagna."
}
]
},
{
"id": "sasa_yoga",
"name": "Sasa Yoga",
"type": "raj_yoga",
"category": "Panch Mahapurusha",
"active": false,
"description": "Saturn in own or exalted sign in a kendra from Lagna.",
"planets": [
"Saturn"
],
"houses_involved": [
11
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "Saturn is not in own/exalted sign in a kendra from Lagna."
}
]
},
{
"id": "raj_yoga",
"name": "Raj Yoga",
"type": "raj_yoga",
"category": "Power",
"active": true,
"description": "A kendra lord and trikona lord are related by conjunction, Vedic aspect, or exchange.",
"planets": [
"Mercury",
"Saturn",
"Sun"
],
"houses_involved": [
4,
5,
9
],
"strength": "Medium",
"evidence": [
{
"kind": "exchange",
"message": "4th lord Sun and 5th lord Mercury: Sun and Mercury are in sign exchange."
},
{
"kind": "vedic_aspect",
"message": "4th lord Sun and 9th lord Saturn: Sun casts a Vedic aspect on Saturn."
},
{
"kind": "vedic_aspect",
"message": "4th lord Sun and 9th lord Saturn: Saturn casts a Vedic aspect on Sun."
},
{
"kind": "weakening_flag",
"message": "Mercury is afflicted by a classical malefic."
}
]
},
{
"id": "dharma_karmadhipati_yoga",
"name": "Dharma-Karmadhipati Yoga",
"type": "raj_yoga",
"category": "Power",
"active": false,
"description": "The 9th and 10th lords are related by conjunction, Vedic aspect, or exchange.",
"planets": [
"Saturn"
],
"houses_involved": [
9,
10
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "The 9th and 10th lords are not related."
}
]
},
{
"id": "dhana_yoga",
"name": "Dhana Yoga",
"type": "dhana_yoga",
"category": "Wealth",
"active": true,
"description": "Wealth lords are related to trinal lords, or the 2nd/11th lord strengthens the other core wealth house.",
"planets": [
"Jupiter",
"Saturn"
],
"houses_involved": [
9,
11
],
"strength": "Weak",
"evidence": [
{
"kind": "exchange",
"message": "11th lord Jupiter and 9th lord Saturn: Jupiter and Saturn are in sign exchange."
},
{
"kind": "weakening_flag",
"message": "Jupiter is debilitated in Capricorn."
},
{
"kind": "weakening_flag",
"message": "Saturn is afflicted by a classical malefic."
}
]
},
{
"id": "vipareeta_raj_yoga",
"name": "Vipareeta Raj Yoga",
"type": "raj_yoga",
"category": "Power",
"active": false,
"description": "The 6th, 8th, or 12th lord is placed in another dusthana.",
"planets": [],
"houses_involved": [
6,
8,
12
],
"strength": null,
"evidence": [
{
"kind": "missing_condition",
"message": "No dusthana lord is placed in another dusthana."
}
]
},
{
"id": "neecha_bhanga_raja_yoga",
"name": "Neecha Bhanga Raja Yoga",
"type": "raj_yoga",
"category": "Cancellation",
"active": true,
"description": "A debilitated planet gains standard debility cancellation.",
"planets": [
"Jupiter"
],
"houses_involved": [
9
],
"strength": "Medium",
"evidence": [
{
"kind": "debility_cancellation",
"message": "Debilitated Jupiter is related to its sign lord Saturn."
},
{
"kind": "debility_cancellation",
"message": "Debilitated Jupiter is related to its exaltation-sign lord Moon."
},
{
"kind": "weakening_flag",
"message": "Jupiter is debilitated in Capricorn."
}
]
}
],
"sade_sati": {
"active": false,
"phase": null,
"description": "Sade Sati not active"
},
"summary": {
"total_evaluated": 18,
"active": 7,
"inactive": 11,
"by_category": {
"Affliction": {
"total": 2,
"active": 1,
"inactive": 1
},
"Grace & Reputation": {
"total": 1,
"active": 0,
"inactive": 1
},
"Intellect": {
"total": 1,
"active": 0,
"inactive": 1
},
"Wealth": {
"total": 2,
"active": 2,
"inactive": 0
},
"Power": {
"total": 4,
"active": 2,
"inactive": 2
},
"Learning": {
"total": 1,
"active": 0,
"inactive": 1
},
"Fortune": {
"total": 1,
"active": 0,
"inactive": 1
},
"Panch Mahapurusha": {
"total": 5,
"active": 1,
"inactive": 4
},
"Cancellation": {
"total": 1,
"active": 1,
"inactive": 0
}
},
"by_type": {
"dosha": {
"total": 2,
"active": 1,
"inactive": 1
},
"auspicious": {
"total": 3,
"active": 0,
"inactive": 3
},
"dhana_yoga": {
"total": 3,
"active": 2,
"inactive": 1
},
"raj_yoga": {
"total": 10,
"active": 4,
"inactive": 6
}
}
},
"metadata": {
"endpoint_version": "v2",
"ruleset_version": "classical_v1",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean",
"timezone_used": "Asia/Kolkata",
"evaluated_rule_ids": [
"manglik_dosha",
"kala_sarpa_yoga",
"gajakesari_yoga",
"budha_aditya_yoga",
"chandra_mangala_yoga",
"adhi_yoga",
"saraswati_yoga",
"lakshmi_yoga",
"ruchaka_yoga",
"bhadra_yoga",
"hamsa_yoga",
"malavya_yoga",
"sasa_yoga",
"raj_yoga",
"dharma_karmadhipati_yoga",
"dhana_yoga",
"vipareeta_raj_yoga",
"neecha_bhanga_raja_yoga"
]
}
}