---
title: "IANA Timezone for Coordinates"
method: GET
path: "/v1/utils/timezone"
tags: ["Utilities"]
---

# IANA Timezone for Coordinates

`GET /v1/utils/timezone`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/utils/timezone`
- Auth: HTTP bearer

Returns the IANA timezone (e.g. Asia/Kolkata) for a latitude and longitude pair.
Fully offline — no external API call.
Accepts ?latitude=&longitude= and/or ?lat=&lon= (any pair that supplies both coordinates).
Examples: ?latitude=19.055&longitude=72.869 (Mumbai), ?lat=19.055&lon=72.869

## Query parameters

- `latitude` number, nullable: Latitude (alias: lat)
- `longitude` number, nullable: Longitude (alias: lon)
- `lat` number, nullable: Alias for latitude
- `lon` number, nullable: Alias for longitude

## Response `200`

Successful Response

- ApiResponseTimezoneResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` TimezoneResponse, required
    - `latitude` number, required: Input latitude.
    - `longitude` number, required: Input longitude.
    - `timezone` string, required: IANA timezone identifier.

## 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)