🌙 Jyotisha API Documentation

Comprehensive Vedic astrology API with nakshatra pada calculations, Vedha analysis, and marriage muhurta.

🧾 All API Endpoints (auto-generated)

This table is generated from the Postman collection JSON created from api_v1.py. Regenerate it anytime with: python tools/generate_postman_collection.py

Method	URL	Group	Description
GET	{{baseUrl}}/agastitara	API v1	Compute Agastitārā (अगस्तितारा) lopa/udaya based on traditional palbhā and phalayoga formulas. Returns: - palbhā (computed from latitude unless provided) - phalayoga and derived target Sun degrees (antar/yoga) - local datetimes when *sāyana* Sun longitude reaches those degrees (within the computed Gregorian year)
GET	{{baseUrl}}/agastitara/rise-set/day	API v1	Compute actual astronomical rise/set times of Agastitārā (Agastya/Canopus) for a given civil date. Returns both Gregorian civil date and BS civil date (when nepali_datetime is available).
GET	{{baseUrl}}/agastitara/suryasiddhanta	API v1	Compute Agastitārā (अगस्तितारा) lopa/udaya using the Surya Siddhānta-style rule shared by the user. Returns the same broad structure as /agastitara, but with method='suryasiddhanta' and Surya Siddhanta phala/targets fields.
GET	{{baseUrl}}/annaprasanna/dates	API v1
GET	{{baseUrl}}/annaprasanna/month	API v1
GET	{{baseUrl}}/ayanamsha	API v1	Compute अयनांश (Ayanamsha) for a day, month, or year. Ayanamsha is the difference between the tropical zodiac (Western) and sidereal zodiac (Indian). It represents the precession of the equinoxes and is essential for accurate astrological calculations. **Input Modes:** - mode=en → 'year' is Gregorian (AD) year - mode=ne → 'bs_year' is Bikram Sambat year **Period Options:** - period=day → Compute for a specific day (requires year, month, day) - period=month → Compute for a month with daily breakdown (requires year, month) - period=year → Compute for a year with monthly breakdown (requires year) **Ayanamsha Types:** - CHITRA_AT_180: Most commonly used (default) - Chitra (Spica) at 180° - RASHTRIYA_PANCHANGA_NAKSHATRA_TRACKING: Lahiri ayanamsha (official Indian panchaanga) - VERNAL_EQUINOX_AT_0: No offset (tropical zodiac) - ASHVINI_STARTING_0: Ashvini nakshatra at 0° **Response includes:** - Ayanamsha offset in degrees, amsha, kala, vikala - DMS format (degrees, minutes, seconds) - Bikram Sambat date conversion - Change over period (for month/year) - Daily/monthly breakdowns (if requested) **Query Parameters:** - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (required) - year: Year (Gregorian if mode=en, required for mode=en) - bs_year: Year (BS if mode=ne, required for mode=ne) - month: Month (1-12, optional, required for period=day or period=month) - day: Day (1-31, optional, required for period=day) - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - ayanamsha_type: Type of ayanamsha (default: CHITRA_AT_180) - period: 'day', 'month', or 'year' (default: year) - daily: Include daily breakdown for month/year (default: False) **Examples:** ``` # Yearly computation for 2025 GET /api/v1/ayanamsha?mode=en&year=2025&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu&period=year # Monthly computation with daily breakdown GET /api/v1/ayanamsha?mode=en&year=2025&month=1&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu&period=month&daily=true # Daily computation GET /api/v1/ayanamsha?mode=en&year=2025&month=1&day=1&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu&period=day # Bikram Sambat year GET /api/v1/ayanamsha?mode=ne&bs_year=2082&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu&period=year ```
GET	{{baseUrl}}/bakri_margi/month	API v1	Planet motion status (Margi/Bakri) for all days in a month. **Margi (मार्गी)** = Direct motion (forward moving) **Bakri (बक्री)** = Retrograde motion (backward moving) **Input Modes:** - mode=en → 'year' and 'month' are Gregorian (Jan–Dec) - mode=ne → 'bs_year' and 'bs_month' are Bikram Sambat months **Output:** - basis: Input parameters (mode, year/month or bs_year/bs_month) - lat, lon, timezone: Location parameters - start_date, end_date: Month boundaries - total_days: Number of days in the month - days: Array of daily planet motion status **Query Parameters:** - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - year: Year (Gregorian if mode=en, required for mode=en) - month: Month 1-12 (Gregorian if mode=en, required for mode=en) - bs_year: BS Year (required for mode=ne) - bs_month: BS Month 1-12 (required for mode=ne) - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (default: en) - script: Output script (default: devanagari) **Examples:** ``` # Gregorian month GET /api/v1/bakri_margi/month?lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&mode=en&year=2025&month=4 # Bikram Sambat month GET /api/v1/bakri_margi/month?lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&mode=ne&bs_year=2082&bs_month=1 ```
GET	{{baseUrl}}/bratabandha/month	API v1
GET	{{baseUrl}}/calendar2/month	API v1
GET	{{baseUrl}}/calendar2/month-festivals	API v1
GET	{{baseUrl}}/calendars/coordinates/{{latitude}}/{{longitude}}/years/{{year}}	API v1
GET	{{baseUrl}}/day_length_based_periods/coordinates/{{latitude}}/{{longitude}}/years/{{year}}/months/{{month}}/days/{{day}}/	API v1
GET	{{baseUrl}}/eclipse/year	API v1	Compute all solar and lunar eclipses for a given year. **Input Modes:** - mode=en → 'year' is Gregorian (AD) year - mode=ne → 'bs_year' is Bikram Sambat year **Response includes:** - Total count of eclipses (solar and lunar) - List of all eclipses with details: - Type (solar/lunar) - Eclipse type (Total, Annular, Partial, Penumbral) - Date and time - Magnitude - Visibility duration - Observability from specified location - Bikram Sambat dates **Query Parameters:** - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (required) - year: Year (Gregorian if mode=en, required for mode=en) - bs_year: Year (BS if mode=ne, required for mode=ne) - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - script: Output script (default: devanagari) **Examples:** ``` # Gregorian year 2025 GET /api/v1/eclipse/year?mode=en&year=2025&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu # Bikram Sambat year 2082 GET /api/v1/eclipse/year?mode=ne&bs_year=2082&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu ```
GET	{{baseUrl}}/equal-day-night/gole-angles	API v1	Compute "gole angles" (based on dinamaan/day-length extrema) for BOTH equinox origins: - March equinox origin (spring) - September equinox origin (autumn) This endpoint returns two kinds of angles: - angles: Sun longitude travel (nirayana longitude delta) from origin to south/north gole (≈ 90° and 270°) - traditional_angles: Sun declination/krānti delta from origin to gole (≈ 23°28') **Input Modes:** - mode=en → 'year' is Gregorian year, equinoxes are taken in that year - mode=ne → 'bs_year' is Bikram Sambat; equinox computations use an approximate Gregorian year (bs_year - 57). Note: March equinox may fall in BS (bs_year-1). The response still includes BS dates where possible. **Example:** GET /api/v1/equal-day-night/gole-angles?mode=ne&bs_year=2082&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu
GET	{{baseUrl}}/equal-day-night/year	API v1	Compute all dates in a year where day length equals night length (equinoxes). This finds days where the number of hours in the day equals the number of hours in the night. Typically, there are 2 such days per year: - Spring Equinox (Vernal Equinox) - Autumn Equinox (Fall Equinox) However, the exact dates can vary slightly depending on location and latitude. **Input Modes:** - mode=en → 'year' is Gregorian (AD) year - mode=ne → 'bs_year' is Bikram Sambat year **Response includes:** - Total count of dates found - List of all dates where day length equals night length - Each date includes: - Date in input calendar format - Day length (hours and minutes) - Night length (hours and minutes) - Difference between day and night (in minutes) - Sunrise, sunset, and next sunrise times - Converted date in other calendar format (if available) - Weekday name **Query Parameters:** - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (required) - year: Year (Gregorian if mode=en, required for mode=en) - bs_year: Year (BS if mode=ne, required for mode=ne) - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - tolerance_minutes: Maximum difference in minutes to consider equal (default: 5) **Examples:** ``` # Gregorian year 2025 GET /api/v1/equal-day-night/year?mode=en&year=2025&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu # Bikram Sambat year 2082 GET /api/v1/equal-day-night/year?mode=ne&bs_year=2082&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu ```
GET	{{baseUrl}}/festivals/search	API v1
GET	{{baseUrl}}/graha-transitions	API v1	Get planetary transitions (मूढ↔अमूढ, बक्री↔मार्गी) for a year Returns only planets that have state transitions: - Moodha → Amoodha (combusted → visible) - Amoodha → Moodha (visible → combusted) - Bakri → Margi (retrograde → direct) - Margi → Bakri (direct → retrograde)
GET	{{baseUrl}}/graha_spashta	API v1
GET	{{baseUrl}}/grahachar	API v1	Compute granular planetary transitions (ग्रहचार) including: - Rashi (राशि) transitions - Nakshatra (नक्षत्र) transitions - Pada (पद) transitions Returns detailed information with BS dates, e.g.: "2083 Baisakh 2, Sun in Mesha rashi, Ashwini nakshatra, 3rd pada at 7:09 AM" Query parameters: - year: Year (required) - month: Month 1-12 (required for 'day' and 'month' periods) - day: Day 1-31 (required for 'day' period) - period: 'day', 'month', or 'year' (default: 'day') - lat, lon, timezone: Location (required) - planet: Planet name (optional, default: all planets) - include_pada: Include pada transitions (default: true) - mode: Calendar mode 'en' or 'ne' (default: 'en') - pakshya: Pakshya filter (optional, e.g. '1_krishna', '2_shukla'). Only works with mode=ne. Filters transitions to only include those within the specified pakshya date range. Examples: - Single day, single planet: /grahachar?year=2083&month=1&day=2&period=day&planet=sun&mode=ne&lat=27.7&lon=85.3&timezone=Asia/Kathmandu - Single day, all planets: /grahachar?year=2083&month=1&day=2&period=day&mode=ne&lat=27.7&lon=85.3&timezone=Asia/Kathmandu - Whole month, single planet: /grahachar?year=2083&month=1&period=month&planet=sun&mode=ne&lat=27.7&lon=85.3&timezone=Asia/Kathmandu - Whole month, all planets: /grahachar?year=2083&month=1&period=month&mode=ne&lat=27.7&lon=85.3&timezone=Asia/Kathmandu - Whole year, single planet: /grahachar?year=2083&period=year&planet=sun&mode=ne&lat=27.7&lon=85.3&timezone=Asia/Kathmandu - Whole year, all planets: /grahachar?year=2083&period=year&mode=ne&lat=27.7&lon=85.3&timezone=Asia/Kathmandu - With pakshya filter: /grahachar?year=2083&period=year&pakshya=1_krishna&mode=ne&lat=27.7&lon=85.3&timezone=Asia/Kathmandu
GET	{{baseUrl}}/health	API v1
GET	{{baseUrl}}/kundali/monthly	API v1	Generate kundali data for a specific day or month. Default behavior: Returns kundali for day 1 (fast, ~1-3 seconds). - Use day parameter to request a specific day (fast) - Use day=0 to request all days in the month (slower, limited to first 10 days) - If no explicit time is provided, sunrise is used per day.
GET	{{baseUrl}}/moodha-amoodha-graha	API v1	Get Moodha (मूढ - combusted) and Amoodha (अमूढ - visible) grahas Smart endpoint that returns: - Single day data if year, month, and day are provided - Month data if year and month are provided - Year data if only year is provided
GET	{{baseUrl}}/moodha-amoodha-graha/month	API v1	Get Moodha and Amoodha grahas for each day in a month
GET	{{baseUrl}}/moodha-amoodha-graha/year	API v1	Get Moodha and Amoodha grahas for each day in a year
GET	{{baseUrl}}/muhurta/graha-comprehensive	API v1
GET	{{baseUrl}}/muhurta/graha-nakshatra-spans	API v1
GET	{{baseUrl}}/muhurta/graha-pada-info	API v1
GET	{{baseUrl}}/muhurta/graha-pada-movement	API v1
GET	{{baseUrl}}/muhurta/graha-vedha	API v1
GET	{{baseUrl}}/muhurta/marriage/basic	API v1	Marriage Muhurta Basic API Returns comprehensive marriage muhurta data including various doshas and yogas that should be avoided for marriage ceremonies based on traditional Vedic astrology. **Input Modes:** - mode=en (AD/Gregorian): Use year, month, start_date, end_date in Gregorian calendar - mode=ne (Nepali/Bikram Sambat): Use bs_year, bs_month, bs_start_date, bs_end_date in BS calendar **Flexible Date Inputs:** - Year only: Returns all data for that year - Year + Month: Returns all days of that month - Date range (start_date, end_date): Returns data for that range **Implemented Marriage Doshas:** - Gandānta (गण्डान्त): Junction doshas at end of Nakṣatras, Tithis, and Lagnas - Kartari Dosh (कर्तरी दोष): Malefic planets flanking the Lagna - Latta Dosa (लत्ता दोष): Specific planetary offsets from Moon's nakshatra - Pata Dosh (पात दोष): Nakshatras at end of specific yogas - Krantisamya Dosh (क्रान्तिसाम्य दोष): Sun and Moon in opposite rashi pairs - Kharjur Yoga (खार्जुर योग): Moon in odd position during specific yogas - Upagraha Dosh (उपग्रह दोष): Moon in specific positions (geographic conditional) - Ardhayama Yoga (अर्धयाम योग): Time-based calculation based on day of week - Kulik Dosh (कुलिक दोष): 15-muhurta system based on day of week - Dagdha Tithi (दग्ध तिथि): Specific tithis inauspicious when Sun is in certain rashis - Jamitra Dosh (जामित्र दोष): Planets in 7th house or 55th position from Lagna/Moon - Location-Based Dosha (देशका आधारमा दोष): Geographic restrictions for different doshas - Bana Dosh (बाणदोष): Nepal-specific complex calculation based on tithi and planetary positions - Sankranti Barjit (सङ्क्रान्ति त्याज्य समय): Time restrictions during sankranti periods - Lagna Dosha (बधिर, अन्ध, पङ्गु लग्न): Deaf, blind, and lame lagna restrictions **Response includes:** - Time windows when each dosha is active - Detailed status information for each dosha - Calculation details and rules - Planetary positions and conditions - Error handling with graceful fallbacks **Examples:** ``` # Year only (Gregorian) GET /api/v1/muhurta/marriage/basic?mode=en&year=2025&lat=27.7&lon=85.3 # Year + Month (Gregorian) GET /api/v1/muhurta/marriage/basic?mode=en&year=2025&month=9&lat=27.7&lon=85.3 # Date range (Gregorian) GET /api/v1/muhurta/marriage/basic?mode=en&start_date=2025-09-05&end_date=2025-09-10&lat=27.7&lon=85.3 # Year only (Bikram Sambat) GET /api/v1/muhurta/marriage/basic?mode=ne&bs_year=2082&lat=27.7&lon=85.3 # Year + Month (Bikram Sambat) GET /api/v1/muhurta/marriage/basic?mode=ne&bs_year=2082&bs_month=6&lat=27.7&lon=85.3 # Date range (Bikram Sambat) GET /api/v1/muhurta/marriage/basic?mode=ne&bs_start_date=2082-06-05&bs_end_date=2082-06-10&lat=27.7&lon=85.3 ```
GET	{{baseUrl}}/muhurta/marriage/data	API v1	Marriage Muhurta Data API - Optimized endpoint for tab-based data loading This endpoint allows clients to fetch specific data types on-demand, improving performance by only computing and returning the data needed for each tab. **Data Types:** 1. `general_info` - Basic day-level information (BS Date, Acceptable, Date (AD), Weekday, Location Based, Verdict, Score, Reasons) 2. `astronomical_data` - Planetary positions and lagna information (BS Date, Date (AD), Sun Rashi, Moon Rashi, Tithi, Nakshatra, Lagna details) 3. `strength_qualitative` - Strength and qualitative analysis (BS Date, Date (AD), Bana, Pancha Shalaka, Sapta Shalaka, Ardhayama, Favorable) 4. `lagna_periods` - Detailed lagna periods throughout the day (Lagna Index, Name, Start/End Time, Duration, Favorable, Active Doshas, Dosha Details) 5. `dosha_analysis` - Comprehensive dosha analysis (All doshas: Gandanta, Kartari, Latta, Pata, Krantisamya, Kharjur, Upagraha, Ardhayama, Kulik, Dagdha Tithi, Jamitra, Location Based, Lagna Dosha, Active Doshas) **Parameters:** - `data_type` (required): One of: general_info, astronomical_data, strength_qualitative, lagna_periods, dosha_analysis - All other parameters are the same as `/muhurta/marriage/basic` endpoint **Examples:** ``` # Get general info only GET /api/v1/muhurta/marriage/data?data_type=general_info&mode=ne&bs_start_date=2082-06-05&bs_end_date=2082-06-05&lat=27.7&lon=85.3&timezone=Asia/Kathmandu # Get astronomical data GET /api/v1/muhurta/marriage/data?data_type=astronomical_data&mode=ne&bs_start_date=2082-06-05&bs_end_date=2082-06-05&lat=27.7&lon=85.3&timezone=Asia/Kathmandu # Get lagna periods (automatically includes lagna_wise computation) GET /api/v1/muhurta/marriage/data?data_type=lagna_periods&mode=ne&bs_start_date=2082-06-05&bs_end_date=2082-06-05&lat=27.7&lon=85.3&timezone=Asia/Kathmandu ```
GET	{{baseUrl}}/muhurta/pada-system-info	API v1
GET	{{baseUrl}}/nakshatra-phala/month	API v1
GET	{{baseUrl}}/nakshatra-sanjna	API v1
GET	{{baseUrl}}/new_house/dates	API v1
GET	{{baseUrl}}/new_house/month	API v1
GET	{{baseUrl}}/panchanga-public	API v1	Exposes major Panchanga fields as 'public variables' for any consumer. Query params : - Either: year, month, day Or: start_date=YYYY-MM-DD, end_date=YYYY-MM-DD - lat, lon, timezone - hour, minute, second (optional; default 06:00:00) - script (optional; default 'devanagari')
GET	{{baseUrl}}/panchanga/comprehensive	API v1
GET	{{baseUrl}}/panchanga/coordinates/{{latitude}}/{{longitude}}/years/{{year}}/months/{{month}}/days/{{day}}	API v1	Returns Panchanga with all fields in the desired script (human-friendly). Optional query params: - script: Output script (devanagari, iast, hk, etc) - end_year, end_month, end_day: Range end (inclusive)
GET	{{baseUrl}}/panchanga/detailed/coordinates/{{latitude}}/{{longitude}}/years/{{year}}/months/{{month}}	API v1	Clean, simple endpoint for panchanga data with filtering by day, month, and pakshya.
GET	{{baseUrl}}/papamsha	API v1	Compute पापांश (Papamsha) information for malefic planets (Sun, Mars, Saturn, Rahu, Ketu). Shows: - When each planet enters each pada (quarter) of nakshatras - Entry time and duration in each pada - Which rashi becomes Papamsha during that period
GET	{{baseUrl}}/planets-rise-set/month	API v1	Planet rise/set times for a month, but returned as UNIQUE rows only (when times change). The API scans days in the month and emits an entry only when (udita_time, asta_time) changes for a given planet (rounded to requested precision).
GET	{{baseUrl}}/sankranti	API v1
GET	{{baseUrl}}/sankranti-phala	API v1
GET	{{baseUrl}}/sankranti-phala/month	API v1	Nakshatra classifications (संज्ञा) and associated works (कार्यहरू) for all days in a month. Based on Nakshatra Prakaranam and Muhurta Chintamani texts. **Classifications (संज्ञा):** - स्थिर (Sthira - Fixed/Stable): उत्तरफाल्गुनी, उत्तराषाढा, उत्तरभाद्रपदा, रोहिणी + Sunday - चर (Chara - Movable): स्वाती, पुनर्वसू, श्रवण, धनिष्ठा, शतभिषा + Monday - उग्र (Ugra - Fierce/Cruel): पूर्वभाद्रपदा, पूर्वाषाढा, पूर्वफाल्गुनी + Tuesday - मिश्र (Mishra - Mixed/Common): विशाखा, कृत्तिका + Wednesday - क्षिप्र (Kshipra - Quick/Light): हस्ता, अश्विनी, पुष्य + Thursday - मृदु (Mridu - Soft/Friendly): मृगशिरा, रेवती, चित्रा, अनुराधा + Friday - तीक्ष्ण (Tikshna - Sharp/Harsh): मूल, ज्येष्ठा, आर्द्रा, अश्लेषा + Saturday **Input Modes:** - mode=en → 'year' and 'month' are Gregorian (Jan–Dec) - mode=ne → 'bs_year' and 'bs_month' are Bikram Sambat months **Output:** - basis: Input parameters (mode, year/month or bs_year/bs_month) - lat, lon, timezone: Location parameters - start_date, end_date: Month boundaries - total_days: Number of days in the month - days: Array of daily nakshatra classification and works **Query Parameters:** - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - year: Year (Gregorian if mode=en, required for mode=en) - month: Month 1-12 (Gregorian if mode=en, required for mode=en) - bs_year: BS Year (required for mode=ne) - bs_month: BS Month 1-12 (required for mode=ne) - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (default: en) - script: Output script (default: devanagari) **Examples:** ``` # Gregorian month GET /api/v1/sankranti-phala/month?lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&mode=en&year=2025&month=4 # Bikram Sambat month GET /api/v1/sankranti-phala/month?lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&mode=ne&bs_year=2082&bs_month=1 ```
GET	{{baseUrl}}/sankranti-phala/year	API v1	Nakshatra classifications (संज्ञा) and associated works (कार्यहरू) for all 12 months in a year. Based on Nakshatra Prakaranam and Muhurta Chintamani texts. **Classifications (संज्ञा):** - स्थिर (Sthira - Fixed/Stable): उत्तरफाल्गुनी, उत्तराषाढा, उत्तरभाद्रपदा, रोहिणी + Sunday - चर (Chara - Movable): स्वाती, पुनर्वसू, श्रवण, धनिष्ठा, शतभिषा + Monday - उग्र (Ugra - Fierce/Cruel): पूर्वभाद्रपदा, पूर्वाषाढा, पूर्वफाल्गुनी + Tuesday - मिश्र (Mishra - Mixed/Common): विशाखा, कृत्तिका + Wednesday - क्षिप्र (Kshipra - Quick/Light): हस्ता, अश्विनी, पुष्य + Thursday - मृदु (Mridu - Soft/Friendly): मृगशिरा, रेवती, चित्रा, अनुराधा + Friday - तीक्ष्ण (Tikshna - Sharp/Harsh): मूल, ज्येष्ठा, आर्द्रा, अश्लेषा + Saturday **Input Modes:** - mode=en → 'year' is Gregorian (Jan–Dec) - mode=ne → 'bs_year' is Bikram Sambat year (12 solar months from Mesha sankranti) **Output:** - basis: Input parameters (mode, year or bs_year) - lat, lon, timezone: Location parameters - total_months: Number of months (12) - months: Array of monthly data, each containing daily nakshatra classification and works **Query Parameters:** - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - year: Year (Gregorian if mode=en, required for mode=en) - bs_year: BS Year (required for mode=ne) - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (default: en) - script: Output script (default: devanagari) **Examples:** ``` # Gregorian year 2025 GET /api/v1/sankranti-phala/year?lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&mode=en&year=2025 # Bikram Sambat year 2082 GET /api/v1/sankranti-phala/year?lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&mode=ne&bs_year=2082 ```
GET	{{baseUrl}}/sankranti-phala/year-summary-table	API v1	Alias for /sankranti-phala/year endpoint. Returns nakshatra classifications (संज्ञा) and associated works (कार्यहरू) for all 12 months in a year, formatted as a summary table. This endpoint accepts the same parameters as /sankranti-phala/year: - lat, lon, timezone: Location parameters (required) - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (default: en) - year: Year (Gregorian if mode=en, or BS year if mode=ne) - bs_year: BS Year (required if mode=ne, can also use 'year' parameter) - script: Output script (default: devanagari) - janma_nakshatra: Native birth nakshatra (optional, for personal sankranti phala) **Examples:** ``` # Bikram Sambat year 2082 GET /api/v1/sankranti-phala/year-summary-table?mode=ne&lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&janma_nakshatra=Bharani&bs_year=2082 # Using 'year' parameter for BS mode GET /api/v1/sankranti-phala/year-summary-table?mode=ne&lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&year=2082 ```
GET	{{baseUrl}}/sankranti/suryasiddhanta	API v1	Compute sankranti timing using Surya Siddhanta method. **Method:** सङ्क्रान्तिको घडी पला = (target_degree - उदयकालिक स्पष्ट सूर्य) / (60 × सूर्यको स्पष्ट गति) Where: - For Baisakh (Mesha, rashi 0): target_degree = 360 - For Jestha (Vrishabha, rashi 1): target_degree = 30 - For Ashadh (Mithuna, rashi 2): target_degree = 60 - For Shrawan (Karka, rashi 3): target_degree = 90 - For remaining sankrantis: add 30 degrees for each subsequent rashi To convert ghati-pala to hours/minutes: divide by 2.5 **Input Modes:** - mode=en → 'year' is Gregorian year - mode=ne → 'year' is Bikram Sambat year **Query Parameters:** - year: Year (required) - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (default: en) - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - rashi_index: Specific rashi index (0-11) to compute. If not provided, computes all 12 sankrantis. **Response includes:** - For each sankranti: - rashi_index, rashi_name, bs_month - sunrise_time, sunrise_sun_degree - target_degree, degree_difference - sun_speed_deg_per_day - ghati_pala (traditional time unit) - hours_after_sunrise - sankranti_time (computed datetime) - formula details **Examples:** ``` # Get all sankrantis for BS year 2082 GET /api/v1/sankranti/suryasiddhanta?mode=ne&year=2082&lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu # Get specific rashi (Shrawan - Karka, index 3) GET /api/v1/sankranti/suryasiddhanta?mode=ne&year=2082&lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu&rashi_index=3 # Get all sankrantis for Gregorian year 2025 GET /api/v1/sankranti/suryasiddhanta?mode=en&year=2025&lat=27.71041&lon=85.34870&timezone=Asia/Kathmandu ```
GET	{{baseUrl}}/sankranti/year-summary	API v1	Year summary of solar months based on consecutive saṅkrāntis. **Input Modes:** - mode=en → 'year' is Gregorian (Jan–Dec of that year) - mode=ne → 'year' is Bikram Sambat. The BS year starts at Meṣa saṅkrānti falling ~mid-April of Gregorian (approx BS-57). We anchor the window from Apr 1 of (year-57) to May 1 of (year-56) to find the Meṣa saṅkrānti that starts that BS year, then take 12 months forward. **Output:** - meta: Metadata about the request and computation - months: 12 items with total_days, month rashi, start/end times, and weekdays **Query Parameters:** - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - year: Year value (required) - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (default: en) - script: Output script (default: devanagari) - month: Specific month (1-12) for detailed daily breakdown (optional) - pakshya: Filter by paksha: "krishna" or "shukla". When provided with month, filters days by paksha (optional) **Examples:** ``` # Get yearly summary GET /api/v1/sankranti/year-summary?lat=27.7172&lon=85.3240&year=2025&mode=en&timezone=Asia/Kathmandu # Get detailed daily breakdown for month 2 (Jyestha) GET /api/v1/sankranti/year-summary?lat=27.7172&lon=85.3240&year=2081&mode=ne&month=2&timezone=Asia/Kathmandu # Get filtered by pakshya (krishna paksha only) for month 1 GET /api/v1/sankranti/year-summary?lat=27.7172&lon=85.3240&year=2080&mode=ne&month=1&pakshya=krishna&timezone=Asia/Kathmandu ```
GET	{{baseUrl}}/sankranti/year-summary-opt	API v1	Optimized version of yearly sankranti summary. Preserves the exact response schema. Same parameters as /api/v1/sankranti/year-summary
GET	{{baseUrl}}/sankrantis	API v1
GET	{{baseUrl}}/sankrantis/year	API v1	Get all 12 sankrantis for a given year with their predictions (phala). This endpoint consolidates all sankrantis for a calendar year and provides comprehensive predictions including: - Sankranti timing and rashi transitions - Phala (predictions) with beneficiaries - Market predictions based on nakshatra and timing - Time-based phala (when sankranti occurs during day/night) **Input Modes:** - mode=en → 'year' is Gregorian (AD) year - mode=ne → 'bs_year' is Bikram Sambat year **Response includes:** - Total count (should be 12 sankrantis) - List of all 12 sankrantis with: - Sankranti timing (Gregorian and BS dates) - Rashi transitions (from/to) - Bikram Sambat month assignment - Festival date and rule type - Sankranti phala (name, beneficiaries) - Phala context (nakshatra, sanjna, weekday, market predictions) - Time-based phala (if sankranti occurs during specific time periods) - Additional panchanga details **Query Parameters:** - mode: 'en' for Gregorian, 'ne' for Bikram Sambat (required) - year: Year (Gregorian if mode=en, required for mode=en) - bs_year: Year (BS if mode=ne, required for mode=ne) - lat: Latitude (required) - lon: Longitude (required) - timezone: Timezone string (default: Asia/Kathmandu) - script: Script for output (default: devanagari) **Examples:** ``` # Gregorian year 2025 GET /api/v1/sankrantis/year?mode=en&year=2025&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu # Bikram Sambat year 2082 GET /api/v1/sankrantis/year?mode=ne&bs_year=2082&lat=27.7172&lon=85.3240&timezone=Asia/Kathmandu ```
GET	{{baseUrl}}/suryakranti/month	API v1	Compute daily सूर्यक्रान्ति for each day of a month. Returns a per-day list including: - sunrise-time सूर्यस्पष्ट (nirayana) - computed अयनांश from इष्टशक - सायनसूर्य and reduced 0..90 value - क्रान्ति (north/south)
GET	{{baseUrl}}/timezones/{{timezone}}/times/years/{{year}}/months/{{month}}/days/{{day}}/hours/{{hour}}/minutes/{{minute}}/seconds/{{second}}/bodies/{{body}}/raashi_transition_100_days	API v1
GET	{{baseUrl}}/timezones/{{timezone}}/times/years/{{year}}/months/{{month}}/days/{{day}}/hours/{{hour}}/minutes/{{minute}}/seconds/{{second}}/bodies/{{body}}/{{anga_type_str}}	API v1
GET	{{baseUrl}}/timezones/{{timezone}}/times/years/{{year}}/months/{{month}}/days/{{day}}/hours/{{hour}}/minutes/{{minute}}/seconds/{{second}}/raashi	API v1
GET	{{baseUrl}}/udita-asta-graha	API v1	Compute udita (rising) and asta (setting) directions for planets. Based on shastric rules: - Planets slower than Sun: rise in east (पूर्व), set in west (पश्चिम) - Planets faster than Sun: rise in west (पश्चिम), set in east (पूर्व) Also includes planet-specific laghva periods for state transitions.
GET	{{baseUrl}}/udita-asta-graha/month	API v1	Compute udita (rising) and asta (setting) for planets for each day in a month. Returns daily data including: - Sunrise/sunset times - Planet states (udita direction, asta direction, motion type) - Planet degrees at sunrise/sunset - Rashi indices
GET	{{baseUrl}}/udita-asta-graha/year	API v1	Compute udita (rising) and asta (setting) for planets for each day in a year. Returns yearly data including: - Monthly summaries - Daily data for all days in the year - Planet states, degrees, and transitions
GET	{{festivalBaseUrl}}/search	Festivals

📋 Available Endpoints

🌟 Key Features

🚀 Usage Recommendations

• For basic analysis: Use /muhurta/graha-comprehensive with default parameters
• For detailed movement: Enable include_movement=1 with appropriate time_step_hours
• For vedha analysis: Enable include_vedha=1 with vedha_wheel=both
• For performance: Use larger time_step_hours for longer date ranges
• For precision: Use smaller time_step_hours for detailed analysis

🔧 Technical Notes

• All calculations use sidereal longitude
• Timezone handling supports both zoneinfo and pytz
• Date ranges are limited to 3 days maximum for the comprehensive endpoint
• Planet-specific optimizations are automatically applied
• Infinite loop protection is built into all movement calculations