Basic Astro Details
Returns a concise summary of the most essential Vedic astrological identifiers for a person from their birth date, time, and geographic coordinates — providing the key chart markers needed for lightweight integrations, quick lookups, and summary displays without the full depth of a complete birth chart computation.
What this API does
The Basic Astro Details endpoint is a streamlined alternative to the full Birth Details endpoint, designed for use cases that require only the core astrological identifiers rather than the complete set of planetary positions, house cusps, and dasha timelines. It computes the most commonly needed Vedic chart markers — such as the Ascendant (Lagna), Moon sign (Rashi), Sun sign, birth Nakshatra, Tithi, Yoga, and Karana — from the provided birth data.
This endpoint is optimized for speed and simplicity, making it well-suited for scenarios where a quick astrological profile is needed — such as displaying a user's key chart identifiers on a dashboard, populating a profile card, or performing a fast compatibility pre-check based on Rashi and Nakshatra alone. It uses the same sidereal computation engine and ayanamsha support as the full Birth Details endpoint, ensuring accuracy and consistency across the API suite.
What data it returns
The API returns a structured JSON response including:
- Ascendant (Lagna): The rising sign at the time of birth, its degree, and the Nakshatra on the Ascendant
- Moon sign (Rashi): The sidereal sign occupied by the Moon at birth, along with its ruling planet
- Sun sign: The sidereal sign occupied by the Sun at birth
- Birth Nakshatra: The lunar mansion (Nakshatra) occupied by the Moon, its lord, Pada, and associated qualities
- Tithi: The lunar day at the time of birth, including its name, number, and type
- Yoga: The Vedic Yoga active at the time of birth, derived from the combined longitudes of the Sun and Moon
- Karana: The half-lunar-day (Karana) active at the time of birth
- Current Dasha: The major Vimshottari Dasha period active at the time of birth or query, including the dasha lord and remaining duration
- Basic chart summary: A concise set of key astrological identifiers presented in a format suitable for profile displays and summary cards
Main use cases
- User profile and dashboard displays in astrology apps where a compact set of key chart identifiers — Lagna, Rashi, Nakshatra, current Dasha — is shown on a home screen, profile card, or account summary without loading the full birth chart
- Quick astrological onboarding where a new user's birth details are submitted and their core chart markers are immediately displayed as part of a welcome or setup flow
- Nakshatra and Rashi-based feature gating in apps that unlock or personalize content based on the user's Moon sign or birth star, requiring only these two identifiers rather than the full chart
- Compatibility pre-screening that performs a fast Rashi- or Nakshatra-level compatibility check between two individuals before invoking a full compatibility analysis
- Daily horoscope and panchang personalization where the user's Rashi, Nakshatra, Tithi, Yoga, and Karana are used to filter or personalize daily astrological content
- Lightweight API integrations in third-party apps, widgets, or notification services that need a small, fast astrological data payload without the overhead of a full birth chart response
- Summary sections in comprehensive horoscope reports where the basic chart identifiers are displayed as a header or at-a-glance section before the detailed analysis begins
Key functionality
- Concise, focused response: Returns only the most essential Vedic astrological identifiers — Lagna, Rashi, Sun sign, Nakshatra, Tithi, Yoga, Karana, and current Dasha — in a compact payload optimized for speed and ease of consumption.
- Same computation engine as Birth Details: Uses the same sidereal planetary calculation engine and ayanamsha support as the full Birth Details endpoint, ensuring that the basic identifiers are accurate and consistent with any full chart data computed for the same birth details.
- Ayanamsha selection: The
X-Ayanamsha header allows selection of the sidereal calculation system (e.g., Lahiri, Raman, KP), ensuring the chart markers are computed according to the practitioner's or platform's preferred Vedic tradition.
- Panchang elements included: Returns the Tithi, Yoga, and Karana active at the time of birth alongside the chart identifiers, making the response useful for panchang-based personalization and daily content features without a separate panchang API call.
- Current Dasha identification: Identifies the major Vimshottari Dasha period active at birth, providing immediate context for the native's current planetary period without requiring a full dasha timeline computation.
- Lightweight integration footprint: The reduced response size and focused data set make this endpoint well-suited for mobile applications, widgets, and integrations where bandwidth, latency, or payload size are considerations.
- Geographic coordinate support: Uses latitude and longitude for precise Ascendant calculation, ensuring accuracy for birth locations anywhere in the world.
- Multilingual support: The
Accept-Language header enables localized sign names, Nakshatra names, and other astrological terms, making the API suitable for a global, multilingual user base.
