POST/v1/astro/panchanga/hora

Planetary hours (Hora)

Calculates all 24 Hora (planetary hours) for a date and location, using unequal seasonal hours. Sunrise to sunset and sunset to next sunrise are each split into 12 equal parts. The first hora after sunrise is ruled by the sunrise-boundary Vedic vara lord; subsequent horas follow the Chaldean sequence. Response includes a convention field naming the division used.

GET works too

GET /v1/astro/panchanga/hora: Same answer as the POST route with the same fields as query parameters; cacheable (public, 10 minutes). Current-moment flags such as is_current may lag by up to the cache age.

Request parameters

daterequired

string

Date in YYYY-MM-DD format

locationoptional

string | null

City name. Example: 'Mumbai'

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 string

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.status

string

ok, or no_sunrise when the place has no sunrise or sunset on that date (polar latitudes): the window fields are then null.

data.status_detail

string | null

Plain-English reason when status is not ok.

data.date

string

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

data.convention

string | null

Hora division used. unequal_seasonal = 12 day + 12 night parts from real sunrise/sunset (panchanga / electional).

data.sunrise

string | null

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 | null

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

string | null

Next day sunrise time in HH:MM local time.

data.next_sunrise_at

string | null

Next day sunrise time, ISO 8601 local time with date and UTC offset.

data.next_sunrise_utc

string | null

Next day sunrise time, ISO 8601 UTC with Z.

data.horas

array[HoraPeriod] | null

24 planetary hours: 12 from sunrise to sunset, then 12 from sunset to next sunrise.

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
• Rahu Kaal, Gulika Kaal, Yamaganda Kaal
• Tamil Panchanga

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/panchanga/hora" \
  -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_ext_request import PanchangaExtRequest

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

request = PanchangaExtRequest(
    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_hora(panchanga_ext_request=request)
    print(result)

TypeScript

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

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

const result = await panchangaHora({
  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",
    "convention": "unequal_seasonal",
    "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",
    "next_sunrise": "05:30",
    "next_sunrise_at": "1990-05-16T05:30:09+05:30",
    "next_sunrise_utc": "1990-05-16T00:00:09Z",
    "horas": [
      {
        "hora": 1,
        "ruling_planet": "Mars",
        "start": "05:31",
        "start_at": "1990-05-15T05:30:44+05:30",
        "start_utc": "1990-05-15T00:00:44Z",
        "end": "06:39",
        "end_at": "1990-05-15T06:38:33+05:30",
        "end_utc": "1990-05-15T01:08:33Z",
        "quality": "Physical activity, surgery, courage, property dealings, conflict resolution, siblings",
        "is_current": false
      },
      {
        "hora": 2,
        "ruling_planet": "Sun",
        "start": "06:39",
        "start_at": "1990-05-15T06:38:33+05:30",
        "start_utc": "1990-05-15T01:08:33Z",
        "end": "07:46",
        "end_at": "1990-05-15T07:46:22+05:30",
        "end_utc": "1990-05-15T02:16:22Z",
        "quality": "Leadership, government work, authority, dealing with officials, father-related matters",
        "is_current": false
      },
      "... and 22 more items"
    ],
    "status": "ok"
  }
}