GET/v1/astro/panchanga/tamil

Tamil Panchanga

Tamil-specific Panchanga for a date and location. Returns all four Tamil inauspicious periods (Rahu Kalam, Yamagandam, Kuligai, Emagandam), Nalla Neram (auspicious daytime windows between inauspicious 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

longitudeoptional

number | null

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.sunset

string

Sunset time in HH:MM local time.

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.end

string

Period end time in HH:MM local time.

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.end

string

Period end time in HH:MM local time.

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.end

string

Period end time in HH:MM local time.

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.end

string

Period end time in HH:MM local time.

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]

Auspicious daytime windows between the four inauspicious periods.

data.nalla_neram[].start

string

Auspicious window start in HH:MM local time.

data.nalla_neram[].end

string

Auspicious window end in HH:MM local time.

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
• Daily Panchanga
• Hindu festival calendar
• Monthly Panchanga calendar
• Monthly Panchanga calendar (JSON body)
• 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:29",
    "sunset": "19:03",
    "tamil_month": "Vaikasi",
    "rahu_kalam": {
      "start": "15:40",
      "end": "17:22",
      "duration_minutes": 102,
      "is_active": false
    },
    "yamagandam": {
      "start": "07:11",
      "end": "08:53",
      "duration_minutes": 102,
      "is_active": false
    },
    "kuligai": {
      "start": "12:16",
      "end": "13:58",
      "duration_minutes": 102,
      "is_active": false
    },
    "emagandam": {
      "start": "08:53",
      "end": "10:34",
      "duration_minutes": 102,
      "is_active": false
    },
    "nalla_neram": [
      {
        "start": "05:29",
        "end": "07:11"
      },
      {
        "start": "10:34",
        "end": "12:16"
      },
      "... and 2 more items"
    ]
  }
}