☰ DiAstrologer API Docs

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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 422HTTPValidationError

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.

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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.

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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 200VedicApiResponse

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.

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 200VedicApiResponse

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 200VedicApiResponse

Example

curl -X POST 'https://api.example.com/api/v1/yoga/vipreet-raja' \
  -H 'Authorization: Bearer <API_KEY>'