POST/v1/astro/panchanga

Daily Panchanga

Calculate Vedic Panchanga for a given date and location. Returns Tithi, Nakshatra, Yoga, Karana, Vara (weekday), and auspicious and inauspicious periods for the day. Returns Tithi, Vara (weekday), Nakshatra, Yoga, and Karana for the birth date and location.

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

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

API key tier does not include this endpoint.

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.

Related endpoints

• Choghadiya periods
• Hindu festival calendar
• Monthly Panchanga calendar
• Monthly Panchanga calendar (JSON body)
• Planetary hours (Hora)
• Rahu Kaal, Gulika Kaal, Yamaganda Kaal
• Tamil Panchanga

Request

POST·application/json

curl

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"}'

Python

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)

TypeScript

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": {
    "tithi": {
      "number": 20,
      "name": "Panchami",
      "paksha": "Krishna",
      "degrees_elapsed": 9.0905,
      "degrees_remaining": 2.9095,
      "end_time": "1990-05-15T06:09:28Z"
    },
    "vara": {
      "number": 2,
      "name": "Somvar",
      "lord": "Moon",
      "end_time": null
    },
    "nakshatra": {
      "index": 20,
      "name": "Uttara Ashadha",
      "pada": 1,
      "degrees_elapsed": 0.6146,
      "degrees_remaining": 12.7187,
      "end_time": "1990-05-16T00:41:05Z"
    },
    "yoga": {
      "index": 22,
      "name": "Shubha",
      "is_inauspicious": false,
      "degrees_elapsed": 4.1387,
      "end_time": "1990-05-15T16:36:20Z"
    },
    "karana": {
      "number": 40,
      "name": "Taitila",
      "degrees_elapsed": 3.0905,
      "degrees_remaining": 2.9095,
      "end_time": "1990-05-15T06:09:28Z"
    }
  }
}