---
title: "Planetary hours (Hora) (GET)"
method: GET
path: "/v1/astro/panchanga/hora"
---

# Planetary hours (Hora) (GET)

`GET /v1/astro/panchanga/hora`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/astro/panchanga/hora`
- Auth: HTTP bearer

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.

## Query parameters

- `date` string, required: Date, YYYY-MM-DD (local civil date at the place).
- `location` string, nullable: City name, used when latitude/longitude/timezone are not given.
- `latitude` number, nullable: Latitude in decimal degrees, north positive.
- `longitude` number, nullable: Longitude in decimal degrees, east positive.
- `timezone` string, nullable: IANA timezone, e.g. Asia/Kolkata.

## Response `200`

Successful Response

- ApiResponseHoraResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` HoraResponse, required
    - `status` 'ok' | 'no_sunrise': ok, or no_sunrise when the place has no sunrise or sunset on that date (polar latitudes): the window fields are then null.
    - `status_detail` string, nullable: Plain-English reason when status is not ok.
    - `date` string, required: Date for which Hora is calculated (YYYY-MM-DD).
    - `convention` string, nullable: Hora division used. ``unequal_seasonal`` = 12 day + 12 night parts from real sunrise/sunset (panchanga / electional).
    - `sunrise` string, nullable: Sunrise time in HH:MM local time.
    - `sunrise_at` string, nullable: Sunrise time, ISO 8601 local time with date and UTC offset.
    - `sunrise_utc` string, nullable: Sunrise time, ISO 8601 UTC with Z.
    - `sunset` string, nullable: Sunset time in HH:MM local time.
    - `sunset_at` string, nullable: Sunset time, ISO 8601 local time with date and UTC offset.
    - `sunset_utc` string, nullable: Sunset time, ISO 8601 UTC with Z.
    - `next_sunrise` string, nullable: Next day sunrise time in HH:MM local time.
    - `next_sunrise_at` string, nullable: Next day sunrise time, ISO 8601 local time with date and UTC offset.
    - `next_sunrise_utc` string, nullable: Next day sunrise time, ISO 8601 UTC with Z.
    - `horas` HoraPeriod[], nullable: 24 planetary hours: 12 from sunrise to sunset, then 12 from sunset to next sunrise.
      - `hora` integer, required: Hora number, 1 to 24.
      - `ruling_planet` string, required: Planet ruling this hora.
      - `start` string, required: Hora start time in HH:MM local time.
      - `start_at` string, nullable: Hora start time, ISO 8601 local time with date and UTC offset.
      - `start_utc` string, nullable: Hora start time, ISO 8601 UTC with Z.
      - `end` string, required: Hora end time in HH:MM local time.
      - `end_at` string, nullable: Hora end time, ISO 8601 local time with date and UTC offset.
      - `end_utc` string, nullable: Hora end time, ISO 8601 UTC with Z.
      - `quality` string, required: Activities suited to this planetary hora.
      - `is_current` boolean, required: True if this hora is currently active.

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)