☰ DiAstrologer API Docs

Transit

15 endpoint(s).

Endpoint Method Summary Auth
/api/v1/transit/ashtakavarga POST Transit with Ashtakavarga
/api/v1/transit/current POST Current Transits
/api/v1/transit/dhaiya POST Dhaiya (Small Panoti)
/api/v1/transit/double-transit POST Double Transit (Jupiter + Saturn)
/api/v1/transit/from-moon POST Gochar Effects from Moon
/api/v1/transit/jupiter POST Jupiter Transit
/api/v1/transit/mars POST Mars Transit
/api/v1/transit/mercury POST Mercury Transit
/api/v1/transit/moon-transit POST Moon Transit
/api/v1/transit/rahu-ketu POST Rahu-Ketu Transit
/api/v1/transit/sade-sati POST Sade Sati Analysis
/api/v1/transit/saturn POST Saturn Transit
/api/v1/transit/sun POST Sun Transit
/api/v1/transit/vedha POST Vedha (Transit Obstruction)
/api/v1/transit/venus POST Venus Transit

POST /api/v1/transit/ashtakavarga

Transit with Ashtakavarga

Transit analysis using Ashtakavarga bindus.

Combines Gochar with BAV points for more accurate predictions. Transits are stronger when planets pass through houses with more bindus.

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

POST /api/v1/transit/current

Current Transits

Get current planetary transit positions.

Shows where each planet is currently transiting and its house position from natal Moon.

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

POST /api/v1/transit/dhaiya

Dhaiya (Small Panoti)

Dhaiya analysis - Saturn's transit over 4th or 8th from Moon.

Also called 'Small Panoti' or 'Kantak Shani / Ashtama Shani'. Duration: ~2.5 years.

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

POST /api/v1/transit/double-transit

Double Transit (Jupiter + Saturn)

Double Transit analysis - Jupiter and Saturn combined aspect.

Events manifest when BOTH Jupiter AND Saturn aspect the same house. This is a key timing technique in Vedic astrology.

Jupiter aspects: 1st (placement), 5th, 7th, 9th from its position Saturn aspects: 1st (placement), 3rd, 7th, 10th from its position

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

POST /api/v1/transit/from-moon

Gochar Effects from Moon

Detailed Gochar (transit) analysis from Moon sign.

Classical Vedic transit analysis using Moon as reference. Includes Vedha (obstruction) checking.

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/transit/from-moon' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/transit/jupiter

Jupiter Transit

Jupiter transit analysis.

Jupiter stays ~1 year per sign. Brings expansion to the house it transits.

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

POST /api/v1/transit/mars

Mars Transit

Mars transit analysis from natal Moon.

Mars takes ~45 days per sign. Important for: - Energy and action - Conflicts and competitions - Property and siblings

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

POST /api/v1/transit/mercury

Mercury Transit

Mercury transit analysis from natal Moon.

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

POST /api/v1/transit/moon-transit

Moon Transit

Moon transit analysis - daily emotional trends.

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

POST /api/v1/transit/rahu-ketu

Rahu-Ketu Transit

Rahu-Ketu (nodal) transit analysis.

Rahu and Ketu stay ~18 months per sign. They always transit opposite signs.

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/transit/rahu-ketu' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/transit/sade-sati

Sade Sati Analysis

Complete Sade Sati (7.5 years Saturn) analysis.

Checks current phase, effects, and remedies.

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/transit/sade-sati' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/transit/saturn

Saturn Transit

Complete Saturn transit analysis.

Saturn stays ~2.5 years per sign. Brings lessons and restructuring.

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

POST /api/v1/transit/sun

Sun Transit

Sun transit analysis from natal Moon.

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

POST /api/v1/transit/vedha

Vedha (Transit Obstruction)

Vedha (obstruction) analysis for all transits.

Vedha modifies transit results - good transits may lose benefit, bad transits may cause less harm when vedha is present.

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

POST /api/v1/transit/venus

Venus Transit

Venus transit analysis from natal Moon.

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