---
title: "Rahu Kaal (GET)"
method: GET
path: "/v1/astro/panchanga/rahu-kaal"
---

# Rahu Kaal (GET)

`GET /v1/astro/panchanga/rahu-kaal`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/astro/panchanga/rahu-kaal`
- 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

- ApiResponseRahuKaalResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` RahuKaalResponse, 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 Rahu Kaal is calculated (YYYY-MM-DD).
    - `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.
    - `rahu_kaal` KaalPeriod
      - `start` string, required: Period start time in HH:MM local time.
      - `start_at` string, nullable: Period start time, ISO 8601 local time with date and UTC offset.
      - `start_utc` string, nullable: Period start time, ISO 8601 UTC with Z.
      - `end` string, required: Period end time in HH:MM local time.
      - `end_at` string, nullable: Period end time, ISO 8601 local time with date and UTC offset.
      - `end_utc` string, nullable: Period end time, ISO 8601 UTC with Z.
      - `duration_minutes` integer, required: Duration of the period in minutes.
      - `is_active` boolean, required: True if this period is currently active.
    - `gulika_kaal` KaalPeriod
      - `start` string, required: Period start time in HH:MM local time.
      - `start_at` string, nullable: Period start time, ISO 8601 local time with date and UTC offset.
      - `start_utc` string, nullable: Period start time, ISO 8601 UTC with Z.
      - `end` string, required: Period end time in HH:MM local time.
      - `end_at` string, nullable: Period end time, ISO 8601 local time with date and UTC offset.
      - `end_utc` string, nullable: Period end time, ISO 8601 UTC with Z.
      - `duration_minutes` integer, required: Duration of the period in minutes.
      - `is_active` boolean, required: True if this period is currently active.
    - `yamaganda_kaal` KaalPeriod
      - `start` string, required: Period start time in HH:MM local time.
      - `start_at` string, nullable: Period start time, ISO 8601 local time with date and UTC offset.
      - `start_utc` string, nullable: Period start time, ISO 8601 UTC with Z.
      - `end` string, required: Period end time in HH:MM local time.
      - `end_at` string, nullable: Period end time, ISO 8601 local time with date and UTC offset.
      - `end_utc` string, nullable: Period end time, ISO 8601 UTC with Z.
      - `duration_minutes` integer, required: Duration of the period in minutes.
      - `is_active` boolean, required: True if this period 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/e77850f7c569?raw)