☰ DiAstrologer API Docs

Dasha

11 endpoint(s).

Endpoint Method Summary Auth
/api/v1/dasha/antardasha POST Antardasha Periods
/api/v1/dasha/ashtottari POST Ashtottari Dasha
/api/v1/dasha/chara POST Chara Dasha (Jaimini)
/api/v1/dasha/current POST Current Dasha
/api/v1/dasha/effects POST Dasha Effects
/api/v1/dasha/prana POST Prana Dasha (5th Level)
/api/v1/dasha/pratyantardasha POST Pratyantardasha Periods
/api/v1/dasha/sookshma POST Sookshma Dasha (4th Level)
/api/v1/dasha/timeline POST Dasha Timeline
/api/v1/dasha/vimshottari POST Vimshottari Dasha
/api/v1/dasha/yogini POST Yogini Dasha

POST /api/v1/dasha/antardasha

Antardasha Periods

Calculate Antardasha (sub-periods) within current or specified Mahadasha.

Each Mahadasha has 9 Antardashas in proportional periods.

Param In Type Required Description
mahadasha_lord query string no

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/dasha/antardasha' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/ashtottari

Ashtottari Dasha

Calculate Ashtottari Dasha (108-year cycle).

Uses 8 planets (excludes Ketu). Applicable when Rahu is in kendra/trikona from lagna lord.

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/dasha/ashtottari' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/chara

Chara Dasha (Jaimini)

Calculate Chara Dasha (Jaimini system).

Sign-based dasha system. Duration based on sign's distance from its lord.

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/dasha/chara' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/current

Current Dasha

Get currently running Dasha at all levels.

Returns current Mahadasha, Antardasha, Pratyantardasha with remaining time and effects.

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/dasha/current' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/effects

Dasha Effects

Get predicted effects for a dasha period.

Uses database rules from पाराशरी ज्योतिष for dasha lordship effects.

Param In Type Required Description
mahadasha_lord query string no
antardasha_lord query string no

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/dasha/effects' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/prana

Prana Dasha (5th Level)

Calculate Prana Dasha (5th level - finest periods).

Used for very precise timing, each period lasts only days.

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/dasha/prana' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/pratyantardasha

Pratyantardasha Periods

Calculate Pratyantardasha (3rd level sub-periods).

Each Antardasha has 9 Pratyantardashas.

Param In Type Required Description
mahadasha_lord query string no
antardasha_lord query string no

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/dasha/pratyantardasha' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/sookshma

Sookshma Dasha (4th Level)

Calculate Sookshma Dasha (4th level - very fine periods).

Used for precise timing of events.

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/dasha/sookshma' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/timeline

Dasha Timeline

Get dasha timeline for specified years ahead.

Shows upcoming Mahadasha and Antardasha changes.

Param In Type Required Description
years_ahead query integer no

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/dasha/timeline' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/vimshottari

Vimshottari Dasha

Calculate Vimshottari Mahadasha (120-year cycle).

Based on Moon's nakshatra at birth. Returns all 9 planetary periods with start/end dates.

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/dasha/vimshottari' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/dasha/yogini

Yogini Dasha

Calculate Yogini Dasha (36-year cycle).

8 Yoginis: Mangala, Pingala, Dhanya, Bhramari, Bhadrika, Ulka, Siddha, Sankata.

Popular in North India for timing predictions.

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/dasha/yogini' \
  -H 'Authorization: Bearer <API_KEY>'