POST/v1/astro/panchanga/calendar

Monthly Panchanga calendar

Panchanga for every day of a month at a location, one entry per day. Each day keeps the sunrise tithi, vara, nakshatra, yoga, karana and Rahu Kaal, and adds sunrise, sunset, moonrise, moonset, paksha, the lunar month (amanta and purnimanta, with Adhik months), Bhadra windows, and every tithi, nakshatra, yoga and karana active between that sunrise and the next with ISO start and end times. A kshaya tithi (one no sunrise touches) appears on the day it runs, flagged is_kshaya; a tithi that holds two sunrises is flagged is_vriddhi on both days. Give year (1900-2100), month (1-12) and either location (a city name) or lat and lon (also accepted as latitude and longitude); timezone defaults to Asia/Kolkata.

GET works too

GET /v1/astro/panchanga/calendar: Same answer as POST /v1/astro/panchanga/calendar, with the same fields as query parameters (latitude and longitude for lat and lon).

Request parameters

yearrequired

integer

Year, 1900-2100.

monthrequired

integer

Month, 1-12.

locationoptional

string | null

City name, used when lat and lon are not given.

latoptional

number | null

Latitude in decimal degrees, north positive. Also accepted as latitude.

lonoptional

number | null

Longitude in decimal degrees, east positive. Also accepted as longitude.

timezoneoptional

string

IANA timezone for the location

ayanamsaoptional

string

Ayanamsa system: lahiri (default), raman, kp, or tropical for a zero offset, as on every other chart endpoint

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.year

integer

Year of the calendar.

data.month

integer

Month of the calendar, 1 to 12.

data.timezone

string

IANA timezone used for calculations.

data.ayanamsa

string

Ayanamsa system used.

data.days

array[object]

Panchanga data for every day of the month.

data.days[].date

string

Date in YYYY-MM-DD format.

data.days[].tithi

object

data.days[].tithi.name

string

Tithi name.

data.days[].tithi.number

integer

Tithi number, 1 to 30.

data.days[].tithi.paksha

string

Shukla or Krishna.

data.days[].tithi.end_time

string | null

Tithi end time if available.

data.days[].vara

object

data.days[].vara.name

string

Weekday name in Sanskrit.

data.days[].vara.number

integer

Weekday number, 1 to 7.

data.days[].vara.lord

string | null

Planetary lord of the weekday.

data.days[].nakshatra

object

data.days[].nakshatra.name

string

Nakshatra name.

data.days[].nakshatra.index

integer

Zero-based nakshatra index, 0 to 26.

data.days[].nakshatra.pada

integer

Pada number, 1 to 4.

data.days[].nakshatra.end_time

string | null

Nakshatra end time if available.

data.days[].yoga

object

data.days[].yoga.name

string

Yoga name.

data.days[].yoga.index

integer

Zero-based yoga index, 0 to 26.

data.days[].yoga.is_inauspicious

boolean

True if this yoga is inauspicious.

data.days[].yoga.end_time

string | null

Yoga end time if available.

data.days[].karana

object

data.days[].karana.name

string

Karana name.

data.days[].karana.number

integer

Karana number.

data.days[].karana.end_time

string | null

Karana end time if available.

data.days[].rahu_kaal

object

data.days[].rahu_kaal.start

string

Rahu Kaal start time in HH:MM local time.

data.days[].rahu_kaal.start_at

string | null

Rahu Kaal start time, ISO 8601 local time with date and UTC offset.

data.days[].rahu_kaal.start_utc

string | null

Rahu Kaal start time, ISO 8601 UTC with Z.

data.days[].rahu_kaal.end

string

Rahu Kaal end time in HH:MM local time.

data.days[].rahu_kaal.end_at

string | null

Rahu Kaal end time, ISO 8601 local time with date and UTC offset.

data.days[].rahu_kaal.end_utc

string | null

Rahu Kaal end time, ISO 8601 UTC with Z.

data.days[].sunrise

string | null

Sunrise, ISO 8601 local time with offset.

data.days[].sunset

string | null

Sunset, ISO 8601 local time with offset.

data.days[].moonrise

string | null

First moonrise before the next sunrise. Null if none.

data.days[].moonset

string | null

First moonset before the next sunrise. Null if none.

data.days[].paksha

string | null

Paksha at sunrise.

data.days[].masa

Masa | null

Lunar month at sunrise, amanta and purnimanta.

data.days[].tithis

array[DayTithi] | null

Every tithi active between this sunrise and the next.

data.days[].nakshatras

array[DayNakshatra] | null

Every nakshatra active between this sunrise and the next.

data.days[].yogas

array[DayYoga] | null

Every yoga active between this sunrise and the next.

data.days[].karanas

array[DayKarana] | null

Every karana active between this sunrise and the next.

data.days[].bhadra

array[BhadraWindow] | null

Bhadra (Vishti karana) windows during the day.

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Request

POST·application/json

curl
Python
TypeScript

curl -X POST "https://api.asterwise.com/v1/astro/panchanga/calendar" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":1,"lat":28.6139,"lon":77.209,"timezone":"Asia/Kolkata"}'

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.panchanga_calendar_post_body import PanchangaCalendarPostBody

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

request = PanchangaCalendarPostBody(
    year=2026,
    month=1,
    lat=28.6139,
    lon=77.209,
    timezone="Asia/Kolkata",
)

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

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

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

const result = await panchangaCalendarPost({
  client,
  body: {
      "year": 2026,
      "month": 1,
      "lat": 28.6139,
      "lon": 77.209,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "year": 2026,
    "month": 1,
    "timezone": "Asia/Kolkata",
    "ayanamsa": "lahiri",
    "days": [
      {
        "date": "2026-01-01",
        "tithi": {
          "name": "Trayodashi",
          "number": 13,
          "paksha": "Shukla",
          "end_time": "2026-01-01T16:52:45Z"
        },
        "vara": {
          "number": 5,
          "name": "Guruvar",
          "lord": "Jupiter"
        },
        "nakshatra": {
          "name": "Rohini",
          "index": 3,
          "pada": 2,
          "end_time": "2026-01-01T17:18:35Z"
        },
        "yoga": {
          "name": "Shubha",
          "index": 22,
          "is_inauspicious": false,
          "end_time": "2026-01-01T11:42:42Z"
        },
        "karana": {
          "name": "Kaulava",
          "number": 25,
          "end_time": "2026-01-01T06:36:39Z"
        },
        "rahu_kaal": {
          "start": "13:42",
          "end": "15:00"
        },
        "sunrise": "2026-01-01T07:13:54+05:30",
        "sunset": "2026-01-01T17:35:26+05:30",
        "moonrise": "2026-01-01T15:19:31+05:30",
        "moonset": "2026-01-02T06:01:06+05:30",
        "paksha": "Shukla",
        "masa": {
          "amanta": {
            "index": 10,
            "name": "Pausha",
            "display_name": "Pausha",
            "is_adhik": false
          },
          "purnimanta": {
            "index": 10,
            "name": "Pausha",
            "display_name": "Pausha",
            "is_adhik": false
          },
          "is_kshaya": false
        },
        "tithis": [
          {
            "number": 13,
            "name": "Trayodashi",
            "paksha": "Shukla",
            "fivefold": "Jaya",
            "is_chidra": false,
            "start": "2026-01-01T01:48:28+05:30",
            "end": "2026-01-01T22:22:45+05:30",
            "at_sunrise": true,
            "is_kshaya": false,
            "is_vriddhi": false
          },
          {
            "number": 14,
            "name": "Chaturdashi",
            "paksha": "Shukla",
            "fivefold": "Rikta",
            "is_chidra": true,
            "start": "2026-01-01T22:22:45+05:30",
            "end": "2026-01-02T18:53:59+05:30",
            "at_sunrise": false,
            "is_kshaya": false,
            "is_vriddhi": false
          }
        ],
        "nakshatras": [
          {
            "index": 3,
            "number": 4,
            "name": "Rohini",
            "lord": "Moon",
            "start": "2026-01-01T01:30:11+05:30",
            "end": "2026-01-01T22:48:35+05:30",
            "at_sunrise": true,
            "is_kshaya": false,
            "is_vriddhi": false
          },
          {
            "index": 4,
            "number": 5,
            "name": "Mrigashira",
            "lord": "Mars",
            "start": "2026-01-01T22:48:35+05:30",
            "end": "2026-01-02T20:04:09+05:30",
            "at_sunrise": false,
            "is_kshaya": false,
            "is_vriddhi": false
          }
        ],
        "yogas": [
          {
            "index": 22,
            "number": 23,
            "name": "Shubha",
            "is_inauspicious": false,
            "start": "2025-12-31T21:13:39+05:30",
            "end": "2026-01-01T17:12:42+05:30",
            "at_sunrise": true,
            "is_kshaya": false,
            "is_vriddhi": false
          },
          {
            "index": 23,
            "number": 24,
            "name": "Shukla",
            "is_inauspicious": false,
            "start": "2026-01-01T17:12:42+05:30",
            "end": "2026-01-02T13:07:06+05:30",
            "at_sunrise": false,
            "is_kshaya": false,
            "is_vriddhi": false
          }
        ],
        "karanas": [
          {
            "number": 25,
            "name": "Kaulava",
            "lord": "Mars",
            "is_vishti": false,
            "start": "2026-01-01T01:48:28+05:30",
            "end": "2026-01-01T12:06:39+05:30",
            "at_sunrise": true,
            "is_kshaya": false,
            "is_vriddhi": false
          },
          {
            "number": 26,
            "name": "Taitila",
            "lord": "Mercury",
            "is_vishti": false,
            "start": "2026-01-01T12:06:39+05:30",
            "end": "2026-01-01T22:22:45+05:30",
            "at_sunrise": false,
            "is_kshaya": true,
            "is_vriddhi": false
          },
          "... and 1 more item"
        ],
        "bhadra": []
      },
      {
        "date": "2026-01-02",
        "tithi": {
          "name": "Chaturdashi",
          "number": 14,
          "paksha": "Shukla",
          "end_time": "2026-01-02T13:23:59Z"
        },
        "vara": {
          "number": 6,
          "name": "Shukravar",
          "lord": "Venus"
        },
        "nakshatra": {
          "name": "Mrigashira",
          "index": 4,
          "pada": 2,
          "end_time": "2026-01-02T14:34:09Z"
        },
        "yoga": {
          "name": "Shukla",
          "index": 23,
          "is_inauspicious": false,
          "end_time": "2026-01-02T07:37:06Z"
        },
        "karana": {
          "name": "Garija",
          "number": 27,
          "end_time": "2026-01-02T03:08:05Z"
        },
        "rahu_kaal": {
          "start": "11:07",
          "end": "12:25"
        },
        "sunrise": "2026-01-02T07:14:09+05:30",
        "sunset": "2026-01-02T17:36:08+05:30",
        "moonrise": "2026-01-02T16:23:39+05:30",
        "moonset": "2026-01-03T07:06:40+05:30",
        "paksha": "Shukla",
        "masa": {
          "amanta": {
            "index": 10,
            "name": "Pausha",
            "display_name": "Pausha",
            "is_adhik": false
          },
          "purnimanta": {
            "index": 10,
            "name": "Pausha",
            "display_name": "Pausha",
            "is_adhik": false
          },
          "is_kshaya": false
        },
        "tithis": [
          {
            "number": 14,
            "name": "Chaturdashi",
            "paksha": "Shukla",
            "fivefold": "Rikta",
            "is_chidra": true,
            "start": "2026-01-01T22:22:45+05:30",
            "end": "2026-01-02T18:53:59+05:30",
            "at_sunrise": true,
            "is_kshaya": false,
            "is_vriddhi": false
          },
          {
            "number": 15,
            "name": "Purnima",
            "paksha": "Shukla",
            "fivefold": "Purna",
            "is_chidra": false,
            "start": "2026-01-02T18:53:59+05:30",
            "end": "2026-01-03T15:32:55+05:30",
            "at_sunrise": false,
            "is_kshaya": false,
            "is_vriddhi": false
          }
        ],
        "nakshatras": [
          {
            "index": 4,
            "number": 5,
            "name": "Mrigashira",
            "lord": "Mars",
            "start": "2026-01-01T22:48:35+05:30",
            "end": "2026-01-02T20:04:09+05:30",
            "at_sunrise": true,
            "is_kshaya": false,
            "is_vriddhi": false
          },
          {
            "index": 5,
            "number": 6,
            "name": "Ardra",
            "lord": "Rahu",
            "start": "2026-01-02T20:04:09+05:30",
            "end": "2026-01-03T17:28:03+05:30",
            "at_sunrise": false,
            "is_kshaya": false,
            "is_vriddhi": false
          }
        ],
        "yogas": [
          {
            "index": 23,
            "number": 24,
            "name": "Shukla",
            "is_inauspicious": false,
            "start": "2026-01-01T17:12:42+05:30",
            "end": "2026-01-02T13:07:06+05:30",
            "at_sunrise": true,
            "is_kshaya": false,
            "is_vriddhi": false
          },
          {
            "index": 24,
            "number": 25,
            "name": "Brahma",
            "is_inauspicious": false,
            "start": "2026-01-02T13:07:06+05:30",
            "end": "2026-01-03T09:05:18+05:30",
            "at_sunrise": false,
            "is_kshaya": false,
            "is_vriddhi": false
          }
        ],
        "karanas": [
          {
            "number": 27,
            "name": "Garija",
            "lord": "Jupiter",
            "is_vishti": false,
            "start": "2026-01-01T22:22:45+05:30",
            "end": "2026-01-02T08:38:05+05:30",
            "at_sunrise": true,
            "is_kshaya": false,
            "is_vriddhi": false
          },
          {
            "number": 28,
            "name": "Vanija",
            "lord": "Venus",
            "is_vishti": false,
            "start": "2026-01-02T08:38:05+05:30",
            "end": "2026-01-02T18:53:59+05:30",
            "at_sunrise": false,
            "is_kshaya": true,
            "is_vriddhi": false
          },
          "... and 2 more items"
        ],
        "bhadra": [
          {
            "start": "2026-01-02T18:53:59+05:30",
            "end": "2026-01-03T05:11:48+05:30",
            "residence": "Swarga",
            "residence_english": "Heaven",
            "is_on_earth": false
          }
        ]
      },
      "... and 29 more items"
    ]
  }
}

Request parameters​

Response fields​

Errors​

Related endpoints​

Request parameters

Response fields

Errors

Related endpoints