☰ DiAstrologer API Docs

Nakshatra

12 endpoint(s).

Endpoint Method Summary Auth
/api/v1/nakshatra/all-planets POST All Planets' Nakshatras
/api/v1/nakshatra/analyze POST Comprehensive Nakshatra Analysis (rich DB data)
/api/v1/nakshatra/animal POST Nakshatra Animal
/api/v1/nakshatra/characteristics POST Nakshatra Characteristics
/api/v1/nakshatra/compatibility POST Nakshatra Compatibility
/api/v1/nakshatra/dasha POST Nakshatra Dasha
/api/v1/nakshatra/deity POST Nakshatra Deity
/api/v1/nakshatra/gandanta POST Gandanta Check
/api/v1/nakshatra/lord POST Nakshatra Lords
/api/v1/nakshatra/moon POST Moon's Nakshatra (Janma Nakshatra)
/api/v1/nakshatra/pada POST Pada Analysis
/api/v1/nakshatra/syllables POST Name Syllables

POST /api/v1/nakshatra/all-planets

All Planets' Nakshatras

Get nakshatra positions for all 9 planets.

Returns the nakshatra, pada, and navamsa position for each planet. Useful for comprehensive chart analysis and nakshatra-based 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/nakshatra/all-planets' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/nakshatra/analyze

Comprehensive Nakshatra Analysis (rich DB data)

Full birth-nakshatra deep analysis pulled directly from the rich nakshatras table in PostgreSQL — includes:

Drives the name-correction and self-discovery use-cases.

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

POST /api/v1/nakshatra/animal

Nakshatra Animal

Get the animal symbol of birth nakshatra. Used in Yoni matching for marriage.

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

POST /api/v1/nakshatra/characteristics

Nakshatra Characteristics

Get detailed characteristics of the Janma Nakshatra.

Returns comprehensive information about the birth nakshatra including: - Personality traits - Career tendencies - Health indications - Spiritual path - Favorable/unfavorable aspects

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

POST /api/v1/nakshatra/compatibility

Nakshatra Compatibility

Check nakshatra compatibility with other nakshatras. Used for relationship and partnership analysis.

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

POST /api/v1/nakshatra/dasha

Nakshatra Dasha

Nakshatra-based dasha starting points. Foundation for Vimshottari and other dasha systems.

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

POST /api/v1/nakshatra/deity

Nakshatra Deity

Get the presiding deity of birth nakshatra. Important for worship 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/nakshatra/deity' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/nakshatra/gandanta

Gandanta Check

Check if Moon is in Gandanta (junction) point. Critical spiritual knot between water and fire 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/nakshatra/gandanta' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/nakshatra/lord

Nakshatra Lords

Get nakshatra lords for all planets.

The nakshatra lord is crucial for: - Vimshottari Dasha calculation - Understanding planetary relationships - Predicting 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/nakshatra/lord' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/nakshatra/moon

Moon's Nakshatra (Janma Nakshatra)

Get the Moon's Nakshatra (Janma Nakshatra).

The birth nakshatra is determined by Moon's position and is fundamental for Vimshottari Dasha calculation, personality traits, and compatibility.

Returns complete nakshatra details including: - Nakshatra name and lord - Pada (quarter) and its navamsa - Name syllable for this pada - Gana, Nadi, Yoni for matching - Deity, symbol, characteristics

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

POST /api/v1/nakshatra/pada

Pada Analysis

Detailed pada (quarter) analysis for Moon's nakshatra.

Each nakshatra has 4 padas, each spanning 3°20' and falling in different navamsas. The pada determines: - Name syllable - Navamsa sign - Specific characteristics within the nakshatra

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

POST /api/v1/nakshatra/syllables

Name Syllables

Get recommended name syllables based on Moon's nakshatra pada.

In Vedic tradition, the first syllable of a person's name should match their birth nakshatra pada for auspicious results.

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