GET/v1/astro/panchanga/tamil

Tamil Panchanga

Tamil Panchanga for a date and location: Rahu Kalam, Yamagandam, Kuligai, Nalla Neram and the Tamil solar month. Rahu Kalam, Yamagandam and Kuligai are the Tamil inauspicious periods (emagandam is the Tamil spelling of Yamagandam and repeats the same period), Nalla Neram (daytime windows free of those periods), and the Tamil solar month name derived from the Sun's sidereal position at sunrise.

Request parameters

daterequired

string

Date in YYYY-MM-DD format

locationoptional

string | null

City name

latitudeoptional

number | null

Latitude in decimal degrees, north positive. Use with longitude and timezone instead of location.

longitudeoptional

number | null

Longitude in decimal degrees, east positive. Use with latitude and timezone instead of location.

timezoneoptional

string | null

IANA timezone

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.date

string

Date for which Tamil Panchanga is calculated (YYYY-MM-DD).

data.sunrise

string

Sunrise time in HH:MM local time.

data.sunrise_at

string | null

Sunrise time, ISO 8601 local time with date and UTC offset.

data.sunrise_utc

string | null

Sunrise time, ISO 8601 UTC with Z.

data.sunset

string

Sunset time in HH:MM local time.

data.sunset_at

string | null

Sunset time, ISO 8601 local time with date and UTC offset.

data.sunset_utc

string | null

Sunset time, ISO 8601 UTC with Z.

data.tamil_month

string

Tamil solar month name based on Sun's sidereal sign at sunrise.

data.rahu_kalam

object

data.rahu_kalam.start

string

Period start time in HH:MM local time.

data.rahu_kalam.start_at

string | null

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

data.rahu_kalam.start_utc

string | null

Period start time, ISO 8601 UTC with Z.

data.rahu_kalam.end

string

Period end time in HH:MM local time.

data.rahu_kalam.end_at

string | null

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

data.rahu_kalam.end_utc

string | null

Period end time, ISO 8601 UTC with Z.

data.rahu_kalam.duration_minutes

integer

Duration in minutes.

data.rahu_kalam.is_active

boolean

True if this period is currently active.

data.yamagandam

object

data.yamagandam.start

string

Period start time in HH:MM local time.

data.yamagandam.start_at

string | null

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

data.yamagandam.start_utc

string | null

Period start time, ISO 8601 UTC with Z.

data.yamagandam.end

string

Period end time in HH:MM local time.

data.yamagandam.end_at

string | null

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

data.yamagandam.end_utc

string | null

Period end time, ISO 8601 UTC with Z.

data.yamagandam.duration_minutes

integer

Duration in minutes.

data.yamagandam.is_active

boolean

True if this period is currently active.

data.kuligai

object

data.kuligai.start

string

Period start time in HH:MM local time.

data.kuligai.start_at

string | null

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

data.kuligai.start_utc

string | null

Period start time, ISO 8601 UTC with Z.

data.kuligai.end

string

Period end time in HH:MM local time.

data.kuligai.end_at

string | null

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

data.kuligai.end_utc

string | null

Period end time, ISO 8601 UTC with Z.

data.kuligai.duration_minutes

integer

Duration in minutes.

data.kuligai.is_active

boolean

True if this period is currently active.

data.emagandam

object

data.emagandam.start

string

Period start time in HH:MM local time.

data.emagandam.start_at

string | null

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

data.emagandam.start_utc

string | null

Period start time, ISO 8601 UTC with Z.

data.emagandam.end

string

Period end time in HH:MM local time.

data.emagandam.end_at

string | null

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

data.emagandam.end_utc

string | null

Period end time, ISO 8601 UTC with Z.

data.emagandam.duration_minutes

integer

Duration in minutes.

data.emagandam.is_active

boolean

True if this period is currently active.

data.nalla_neram

array[object]

Daytime windows free of Rahu Kalam, Yamagandam and Kuligai.

data.nalla_neram[].start

string

Auspicious window start in HH:MM local time.

data.nalla_neram[].start_at

string | null

Auspicious window start, ISO 8601 local time with date and UTC offset.

data.nalla_neram[].start_utc

string | null

Auspicious window start, ISO 8601 UTC with Z.

data.nalla_neram[].end

string

Auspicious window end in HH:MM local time.

data.nalla_neram[].end_at

string | null

Auspicious window end, ISO 8601 local time with date and UTC offset.

data.nalla_neram[].end_utc

string | null

Auspicious window end, ISO 8601 UTC with Z.

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.

Related endpoints

• Choghadiya periods
• Daily Panchanga
• Hindu festival and vrat calendar
• Monthly Panchanga calendar
• Planetary hours (Hora)
• Rahu Kaal, Gulika Kaal, Yamaganda Kaal

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/astro/panchanga/tamil?date=1990-05-15&latitude=28.6139&longitude=77.209&timezone=Asia%2FKolkata" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi

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

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.panchanga_tamil(date="1990-05-15",
    latitude=28.6139,
    longitude=77.209,
    timezone="Asia/Kolkata")
    print(result)

TypeScript

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

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

const result = await panchangaTamil({
  client,
  query: {
      "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",
    "sunrise": "05:31",
    "sunrise_at": "1990-05-15T05:30:44+05:30",
    "sunrise_utc": "1990-05-15T00:00:44Z",
    "sunset": "19:05",
    "sunset_at": "1990-05-15T19:04:31+05:30",
    "sunset_utc": "1990-05-15T13:34:31Z",
    "tamil_month": "Vaikasi",
    "rahu_kalam": {
      "start": "15:41",
      "start_at": "1990-05-15T15:41:04+05:30",
      "start_utc": "1990-05-15T10:11:04Z",
      "end": "17:23",
      "end_at": "1990-05-15T17:22:48+05:30",
      "end_utc": "1990-05-15T11:52:48Z",
      "duration_minutes": 102,
      "is_active": false
    },
    "yamagandam": {
      "start": "08:54",
      "start_at": "1990-05-15T08:54:11+05:30",
      "start_utc": "1990-05-15T03:24:11Z",
      "end": "10:36",
      "end_at": "1990-05-15T10:35:54+05:30",
      "end_utc": "1990-05-15T05:05:54Z",
      "duration_minutes": 102,
      "is_active": false
    },
    "kuligai": {
      "start": "12:18",
      "start_at": "1990-05-15T12:17:37+05:30",
      "start_utc": "1990-05-15T06:47:37Z",
      "end": "13:59",
      "end_at": "1990-05-15T13:59:21+05:30",
      "end_utc": "1990-05-15T08:29:21Z",
      "duration_minutes": 102,
      "is_active": false
    },
    "emagandam": {
      "start": "08:54",
      "start_at": "1990-05-15T08:54:11+05:30",
      "start_utc": "1990-05-15T03:24:11Z",
      "end": "10:36",
      "end_at": "1990-05-15T10:35:54+05:30",
      "end_utc": "1990-05-15T05:05:54Z",
      "duration_minutes": 102,
      "is_active": false
    },
    "nalla_neram": [
      {
        "start": "05:31",
        "start_at": "1990-05-15T05:30:44+05:30",
        "start_utc": "1990-05-15T00:00:44Z",
        "end": "08:54",
        "end_at": "1990-05-15T08:54:11+05:30",
        "end_utc": "1990-05-15T03:24:11Z"
      },
      {
        "start": "10:36",
        "start_at": "1990-05-15T10:35:54+05:30",
        "start_utc": "1990-05-15T05:05:54Z",
        "end": "12:18",
        "end_at": "1990-05-15T12:17:37+05:30",
        "end_utc": "1990-05-15T06:47:37Z"
      },
      "... and 2 more items"
    ]
  }
}