POST/v1/astro/panchanga

Daily Panchanga

Vedic Panchanga for a date and location. The top-level tithi, vara, nakshatra, yoga and karana are the limbs at sunrise (or at time when given). The rest describes the whole panchanga day, sunrise to next sunrise: every tithi, nakshatra, yoga and karana active in it with ISO start and end times and kshaya/vriddhi flags; sunrise, sunset, moonrise and moonset; Sun and Moon rashi; lunar month in amanta and purnimanta reckoning (with Adhik months); Vikram, Shaka and Gujarati samvat; ritu and ayana; and the day's timings: Rahu Kaal, Gulika, Yamaganda, Abhijit, Brahma Muhurta, Durmuhurta, Varjyam, Amrit Kaal, Bhadra, Panchaka, Pradosh and others.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string | null

Optional. Name is not used in panchanga calculations.

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

tithi, vara, nakshatra, yoga and karana are the limbs at one instant: sunrise when no time is given, otherwise the given time. The remaining fields describe the whole panchanga day containing that instant (sunrise to next sunrise): every limb active in it, sunrise and moonrise, lunar month, samvat, season and the day's timings.

data.date

string | null

Civil date whose sunrise opens this panchanga day.

data.timezone

string | null

data.sunrise

string | null

Sun's upper limb on the horizon, standard refraction. ISO 8601 local time with UTC offset, e.g. 2026-11-06T10:31:09+05:30.

data.sunset

string | null

data.next_sunrise

string | null

data.moonrise

string | null

First moonrise between this sunrise and the next (disc centre, no refraction). Null if none.

data.moonset

string | null

First moonset between this sunrise and the next. Null if none.

data.day_duration_minutes

number | null

data.night_duration_minutes

number | null

data.paksha

string | null

Paksha at sunrise.

data.tithis

array[DayTithi] | null

Every tithi active between this sunrise and the next, with start and end.

data.nakshatras

array[DayNakshatra] | null

data.yogas

array[DayYoga] | null

data.karanas

array[DayKarana] | null

data.sun_rashi

array[SignSpan] | null

data.moon_rashi

array[SignSpan] | null

data.sun_nakshatra

array[NakshatraSpan] | null

data.masa

Masa | null

data.samvat

Samvat | null

data.ritu

Ritu | null

data.ayana

Ayana | null

data.timings

DayTimings | null

data.tithi

object

data.tithi.number

integer

Tithi number, 1 to 30

data.tithi.name

string

Tithi name, e.g. Pratipada, Purnima, Amavasya

data.tithi.paksha

string

Paksha — Shukla (waxing) or Krishna (waning)

data.tithi.degrees_elapsed

number

Degrees completed within the current tithi

data.tithi.degrees_remaining

number

Degrees remaining until the next tithi

data.tithi.end_time

string | null

data.vara

object

data.vara.number

integer

Weekday number, 1 to 7

data.vara.name

string

Weekday name in Sanskrit, e.g. Ravivar, Somvar

data.vara.lord

string

Planetary lord of the weekday, e.g. Sun, Moon

data.vara.end_time

string | null

data.nakshatra

object

data.nakshatra.index

integer

Zero-based nakshatra index, 0 to 26

data.nakshatra.name

string

Nakshatra name, e.g. Ashwini, Revati

data.nakshatra.pada

integer

Pada number, 1 to 4

data.nakshatra.degrees_elapsed

number

Degrees completed within the current nakshatra

data.nakshatra.degrees_remaining

number

Degrees remaining until the next nakshatra

data.nakshatra.end_time

string | null

data.yoga

object

data.yoga.index

integer

Zero-based yoga index, 0 to 26

data.yoga.name

string

Yoga name, e.g. Vishkumbha, Shiva

data.yoga.is_inauspicious

boolean

True if this yoga is considered inauspicious

data.yoga.degrees_elapsed

number

Degrees completed within the current yoga

data.yoga.end_time

string | null

data.karana

object

data.karana.number

integer

Karana number, 1 to 60

data.karana.name

string

Karana name

data.karana.degrees_elapsed

number

Degrees completed within the current karana

data.karana.degrees_remaining

number

Degrees remaining until the next karana

data.karana.end_time

string | null

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

Reserved; product endpoints are not feature-gated by plan (quota differs by tier).

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Request

POST·application/json

curl
Python
TypeScript

curl -X POST "https://api.asterwise.com/v1/astro/panchanga" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","latitude":28.6139,"longitude":77.209,"timezone":"Asia/Kolkata"}'

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.panchanga_request import PanchangaRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = PanchangaRequest(
    date="1990-05-15",
    latitude=28.6139,
    longitude=77.209,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.panchanga(panchanga_request=request)
    print(result)

import { createClient, createConfig, panchanga } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await panchanga({
  client,
  body: {
      "date": "1990-05-15",
      "latitude": 28.6139,
      "longitude": 77.209,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "date": "1990-05-15",
    "timezone": "Asia/Kolkata",
    "sunrise": "1990-05-15T05:30:44+05:30",
    "sunset": "1990-05-15T19:04:31+05:30",
    "next_sunrise": "1990-05-16T05:30:09+05:30",
    "moonrise": "1990-05-15T23:52:24+05:30",
    "moonset": "1990-05-15T09:33:19+05:30",
    "day_duration_minutes": 813.79,
    "night_duration_minutes": 625.63,
    "paksha": "Krishna",
    "tithis": [
      {
        "at_sunrise": true,
        "is_kshaya": false,
        "is_vriddhi": false,
        "start": "1990-05-14T10:01:15+05:30",
        "end": "1990-05-15T11:39:28+05:30",
        "number": 20,
        "name": "Panchami",
        "paksha": "Krishna",
        "fivefold": "Purna",
        "is_chidra": false
      },
      {
        "at_sunrise": false,
        "is_kshaya": false,
        "is_vriddhi": false,
        "start": "1990-05-15T11:39:28+05:30",
        "end": "1990-05-16T12:47:11+05:30",
        "number": 21,
        "name": "Shashthi",
        "paksha": "Krishna",
        "fivefold": "Nanda",
        "is_chidra": false
      }
    ],
    "nakshatras": [
      {
        "at_sunrise": true,
        "is_kshaya": false,
        "is_vriddhi": true,
        "start": "1990-05-15T04:17:05+05:30",
        "end": "1990-05-16T06:11:06+05:30",
        "index": 20,
        "number": 21,
        "name": "Uttara Ashadha",
        "lord": "Sun",
        "padas": [
          {
            "start": "1990-05-15T04:17:05+05:30",
            "end": "1990-05-15T10:48:28+05:30",
            "pada": 1
          },
          {
            "start": "1990-05-15T10:48:28+05:30",
            "end": "1990-05-15T17:18:00+05:30",
            "pada": 2
          },
          "... and 2 more items"
        ]
      }
    ],
    "yogas": [
      {
        "at_sunrise": true,
        "is_kshaya": false,
        "is_vriddhi": false,
        "start": "1990-05-14T21:57:35+05:30",
        "end": "1990-05-15T22:06:20+05:30",
        "index": 22,
        "number": 23,
        "name": "Shubha",
        "is_inauspicious": false
      },
      {
        "at_sunrise": false,
        "is_kshaya": false,
        "is_vriddhi": false,
        "start": "1990-05-15T22:06:20+05:30",
        "end": "1990-05-16T21:48:55+05:30",
        "index": 23,
        "number": 24,
        "name": "Shukla",
        "is_inauspicious": false
      }
    ],
    "karanas": [
      {
        "at_sunrise": true,
        "is_kshaya": false,
        "is_vriddhi": false,
        "start": "1990-05-14T22:53:38+05:30",
        "end": "1990-05-15T11:39:28+05:30",
        "number": 40,
        "name": "Taitila",
        "lord": "Mercury",
        "is_vishti": false
      },
      {
        "at_sunrise": false,
        "is_kshaya": true,
        "is_vriddhi": false,
        "start": "1990-05-15T11:39:28+05:30",
        "end": "1990-05-16T00:17:40+05:30",
        "number": 41,
        "name": "Garija",
        "lord": "Jupiter",
        "is_vishti": false
      },
      "... and 1 more item"
    ],
    "sun_rashi": [
      {
        "start": "1990-05-15T00:49:01+05:30",
        "end": "1990-06-15T07:23:31+05:30",
        "index": 1,
        "name": "Vrishabha"
      }
    ],
    "moon_rashi": [
      {
        "start": "1990-05-12T23:16:19+05:30",
        "end": "1990-05-15T10:48:28+05:30",
        "index": 8,
        "name": "Dhanu"
      },
      {
        "start": "1990-05-15T10:48:28+05:30",
        "end": "1990-05-17T19:53:47+05:30",
        "index": 9,
        "name": "Makara"
      }
    ],
    "sun_nakshatra": [
      {
        "start": "1990-05-11T13:55:09+05:30",
        "end": "1990-05-25T10:06:22+05:30",
        "index": 2,
        "name": "Krittika"
      }
    ],
    "masa": {
      "amanta": {
        "index": 2,
        "name": "Vaishakha",
        "display_name": "Vaishakha",
        "is_adhik": false
      },
      "purnimanta": {
        "index": 3,
        "name": "Jyeshtha",
        "display_name": "Jyeshtha",
        "is_adhik": false
      },
      "is_kshaya": false
    },
    "samvat": {
      "vikram": 2047,
      "shaka": 1912,
      "gujarati": 2046,
      "samvatsara": "Pramoda"
    },
    "ritu": {
      "vedic": "Vasanta",
      "vedic_english": "Spring",
      "drik": "Grishma",
      "drik_english": "Summer"
    },
    "ayana": {
      "vedic": "Uttarayana",
      "drik": "Uttarayana"
    },
    "timings": {
      "brahma_muhurta": {
        "start": "1990-05-15T04:07:09+05:30",
        "end": "1990-05-15T04:48:57+05:30"
      },
      "pratah_sandhya": {
        "start": "1990-05-15T04:28:03+05:30",
        "end": "1990-05-15T05:30:44+05:30"
      },
      "abhijit": {
        "start": "1990-05-15T11:50:30+05:30",
        "end": "1990-05-15T12:44:45+05:30"
      },
      "vijaya_muhurta": {
        "start": "1990-05-15T14:33:15+05:30",
        "end": "1990-05-15T15:27:30+05:30"
      },
      "godhuli_muhurta": {
        "start": "1990-05-15T19:04:31+05:30",
        "end": "1990-05-15T19:25:22+05:30"
      },
      "sayahna_sandhya": {
        "start": "1990-05-15T19:04:31+05:30",
        "end": "1990-05-15T20:07:05+05:30"
      },
      "nishita_muhurta": {
        "start": "1990-05-15T23:56:29+05:30",
        "end": "1990-05-16T00:38:11+05:30"
      },
      "madhyahna": "1990-05-15T12:17:37+05:30",
      "pradosh": {
        "start": "1990-05-15T19:04:31+05:30",
        "end": "1990-05-15T21:09:39+05:30"
      },
      "rahu_kaal": {
        "start": "1990-05-15T15:41:04+05:30",
        "end": "1990-05-15T17:22:48+05:30"
      },
      "gulika_kaal": {
        "start": "1990-05-15T12:17:37+05:30",
        "end": "1990-05-15T13:59:21+05:30"
      },
      "yamaganda_kaal": {
        "start": "1990-05-15T08:54:11+05:30",
        "end": "1990-05-15T10:35:54+05:30"
      },
      "durmuhurta": [
        {
          "start": "1990-05-15T08:13:29+05:30",
          "end": "1990-05-15T09:07:44+05:30"
        },
        {
          "start": "1990-05-15T23:14:46+05:30",
          "end": "1990-05-15T23:56:29+05:30"
        }
      ],
      "varjyam": [
        {
          "start": "1990-05-15T12:55:05+05:30",
          "end": "1990-05-15T14:38:41+05:30",
          "nakshatra": "Uttara Ashadha"
        }
      ],
      "amrit_kaal": [
        {
          "start": "1990-05-15T23:16:42+05:30",
          "end": "1990-05-16T01:00:18+05:30",
          "nakshatra": "Uttara Ashadha"
        }
      ],
      "bhadra": [],
      "panchaka": [],
      "day_parts": {
        "pratah": {
          "start": "1990-05-15T05:30:44+05:30",
          "end": "1990-05-15T08:13:29+05:30"
        },
        "sangava": {
          "start": "1990-05-15T08:13:29+05:30",
          "end": "1990-05-15T10:56:15+05:30"
        },
        "madhyahna": {
          "start": "1990-05-15T10:56:15+05:30",
          "end": "1990-05-15T13:39:00+05:30"
        },
        "aparahna": {
          "start": "1990-05-15T13:39:00+05:30",
          "end": "1990-05-15T16:21:46+05:30"
        },
        "sayahna": {
          "start": "1990-05-15T16:21:46+05:30",
          "end": "1990-05-15T19:04:31+05:30"
        }
      }
    },
    "tithi": {
      "number": 20,
      "name": "Panchami",
      "paksha": "Krishna",
      "degrees_elapsed": 9.0984,
      "degrees_remaining": 2.9016,
      "end_time": "1990-05-15T06:09:28Z"
    },
    "vara": {
      "number": 3,
      "name": "Mangalvar",
      "lord": "Mars",
      "end_time": "1990-05-16T00:00:08Z"
    },
    "nakshatra": {
      "index": 20,
      "name": "Uttara Ashadha",
      "pada": 1,
      "degrees_elapsed": 0.6231,
      "degrees_remaining": 12.7102,
      "end_time": "1990-05-16T00:41:05Z"
    },
    "yoga": {
      "index": 22,
      "name": "Shubha",
      "is_inauspicious": false,
      "degrees_elapsed": 4.1479,
      "end_time": "1990-05-15T16:36:20Z"
    },
    "karana": {
      "number": 40,
      "name": "Taitila",
      "degrees_elapsed": 3.0984,
      "degrees_remaining": 2.9016,
      "end_time": "1990-05-15T06:09:28Z"
    }
  }
}

Request parameters​

Response fields​

Errors​

Related endpoints​

Request parameters

Response fields

Errors

Related endpoints