Yoga¶
19 endpoint(s).
| Endpoint | Method | Summary | Auth |
|---|---|---|---|
/api/v1/yoga/all |
POST |
All Applicable Yogas | |
/api/v1/yoga/arishta |
POST |
Arishta Yogas | |
/api/v1/yoga/budhaditya |
POST |
Budhaditya Yoga | |
/api/v1/yoga/catalog |
GET |
Yoga catalog (all natal yogas — reference) | |
/api/v1/yoga/catalog/{slug} |
GET |
Single yoga (reference) | |
/api/v1/yoga/chandra |
POST |
Chandra (Moon) Yogas | |
/api/v1/yoga/daridra |
POST |
Daridra (Poverty) Yogas | |
/api/v1/yoga/dhana |
POST |
Dhana Yogas | |
/api/v1/yoga/gajakesari |
POST |
Gajakesari Yoga | |
/api/v1/yoga/lakshmi |
POST |
Lakshmi Yoga | |
/api/v1/yoga/nabhasa |
POST |
Nabhasa Yogas | |
/api/v1/yoga/neecha-bhanga |
POST |
Neecha Bhanga Raja Yogas | |
/api/v1/yoga/pancha-mahapurusha |
POST |
Pancha Mahapurusha Yogas | |
/api/v1/yoga/parivartana |
POST |
Parivartana (Exchange) Yogas | |
/api/v1/yoga/raja |
POST |
Raja Yogas | |
/api/v1/yoga/sannyasa |
POST |
Sannyasa Yoga | |
/api/v1/yoga/summary |
POST |
Yoga Summary | |
/api/v1/yoga/surya |
POST |
Surya (Sun) Yogas | |
/api/v1/yoga/vipreet-raja |
POST |
Vipreet Raja Yogas |
POST /api/v1/yoga/all¶
All Applicable Yogas
Detect all applicable yogas in the chart.
Returns all types: Raja, Dhana, Mahapurusha, Nabhasa, Chandra, etc. Uses classical yoga rules from पाराशरी ज्योतिष.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/all' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/arishta¶
Arishta Yogas
Arishta (Misfortune) yogas - health and longevity concerns. Important for child horoscopes.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/arishta' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/budhaditya¶
Budhaditya Yoga
Budhaditya Yoga - Sun-Mercury conjunction. Intelligence and communication yoga.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/budhaditya' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/v1/yoga/catalog¶
Yoga catalog (all natal yogas — reference)
Return the full natal-yoga catalog from the yoga_catalog table.
Example
curl -X GET 'https://api.example.com/api/v1/yoga/catalog' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/v1/yoga/catalog/{slug}¶
Single yoga (reference)
Return one natal yoga from the yoga_catalog table by slug.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
slug |
path | string | yes |
Response 422 — HTTPValidationError
Example
curl -X GET 'https://api.example.com/api/v1/yoga/catalog/${slug}' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/chandra¶
Chandra (Moon) Yogas
Detect Moon-based yogas.
- Gajakesari: Moon-Jupiter in mutual kendras
- Sunafa: Planets in 2nd from Moon
- Anafa: Planets in 12th from Moon
- Durudhara: Planets on both sides of Moon
- Kemdrum: No planets adjacent to Moon (check cancellation)
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/chandra' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/daridra¶
Daridra (Poverty) Yogas
Detect Daridra Yogas - combinations indicating financial struggles.
Forms when: - Lords of 1st and 2nd in dusthana - 11th lord debilitated or in enemy sign - Malefics in 2nd without benefic aspect
Note: Check for cancellation factors before conclusions.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/daridra' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/dhana¶
Dhana Yogas
Detect Dhana Yogas - combinations for wealth and prosperity.
Key houses: 2nd (accumulated wealth), 11th (gains), 5th (speculation), 9th (fortune). Jupiter, Venus, Mercury involvement strengthens.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/dhana' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/gajakesari¶
Gajakesari Yoga
Gajakesari Yoga - Jupiter and Moon relationship. One of the most auspicious yogas.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/gajakesari' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/lakshmi¶
Lakshmi Yoga
Lakshmi Yoga - Wealth and prosperity yoga. 9th lord strong with Venus.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/lakshmi' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/nabhasa¶
Nabhasa Yogas
Detect Nabhasa Yogas - 32 yogas based on planetary patterns.
Categories: - Akriti (shape): Gada, Shakata, Shringataka, etc. - Sankhya (number): Vallaki, Dama, Pasha, etc. - Ashraya (position): Rajju, Musala, Nala, etc.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/nabhasa' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/neecha-bhanga¶
Neecha Bhanga Raja Yogas
Detect Neecha Bhanga Raja Yogas - cancellation of debilitation.
When a debilitated planet's weakness is cancelled, it gives Raja Yoga results. Cancellation occurs when: - Lord of debilitation sign is in kendra - Lord of exaltation sign is in kendra from Moon/Lagna - Debilitated planet is aspected by its dispositor
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/neecha-bhanga' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/pancha-mahapurusha¶
Pancha Mahapurusha Yogas
Detect Pancha Mahapurusha Yogas - five great personality yogas.
- Ruchaka (Mars): Valor, leadership
- Bhadra (Mercury): Intelligence, communication
- Hamsa (Jupiter): Wisdom, spirituality
- Malavya (Venus): Beauty, luxury, arts
- Shasha (Saturn): Authority, discipline
Forms when planet is in own/exaltation sign in a kendra (1,4,7,10).
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/pancha-mahapurusha' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/parivartana¶
Parivartana (Exchange) Yogas
Detect Parivartana (exchange) yogas.
Forms when two planets are in each other's signs. Types: - Maha Yoga: Between kendra/trikona lords - Khala Yoga: Involving dusthana lords - Dainya Yoga: Between 6/8/12 lords
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/parivartana' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/raja¶
Raja Yogas
Detect Raja Yogas - combinations for power, authority, and success.
Raja Yoga forms when lords of trikona (1,5,9) and kendra (1,4,7,10) houses are connected by conjunction, aspect, or exchange.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/raja' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/sannyasa¶
Sannyasa Yoga
Sannyasa (Renunciation) yoga - spiritual inclination.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/sannyasa' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/summary¶
Yoga Summary
Get a summary of all yogas with strength assessment.
Returns: - Count by yoga type - Strongest yogas - Overall yoga strength score
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/summary' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/surya¶
Surya (Sun) Yogas
Detect Sun-based yogas.
- Veshi: Planets in 2nd from Sun
- Voshi: Planets in 12th from Sun
- Ubhayachari: Planets on both sides of Sun
- Budhaditya: Sun-Mercury conjunction
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/surya' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/yoga/vipreet-raja¶
Vipreet Raja Yogas
Detect Vipreet Raja Yogas - gains through adversity.
Forms when lords of dusthana houses (6, 8, 12) are placed in other dusthana houses. Three types: - Harsha Yoga: 6th lord in 8th/12th - Sarala Yoga: 8th lord in 6th/12th - Vimala Yoga: 12th lord in 6th/8th
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/yoga/vipreet-raja' \
-H 'Authorization: Bearer <API_KEY>'