---
title: "Get Time Zones"
method: GET
path: "/v4/timezones"
tags: ["Reference Data"]
---

# Get Time Zones

`GET /v4/timezones`

Retrieves a list of time zones available on the system along with their relevant details. 
<br />With this endpoint, you can search for specific time zones, paginate results, and sort the data as needed.

## Query parameters

- `countryCode` string
- `searchTerm` string
- `pageSize` integer
- `pageNumber` integer
- `sortBy` 'TimezoneName' | 'Country' | 'CountryCode' — Sort By
- `sortDir` 'Ascending' | 'Descending' — Order Direction

## Response `200`

Returns a list of all the time zones for a given country.

- TimezonesPagedResponse — The paged response containing the entities for the requested page only, and the total number available.
  - `TimeZones` Timezone[], required — An array containing the individual time zone records retrieved by the API. <br />Each record provides specific information about a particular time zone.
    - `TimezoneName` string, nullable — The official name of the time zone. <br />This field is crucial for identifying time zones in the API response and can indicate the region or location it covers.
    - `Country` string, nullable — The name of the country associated with the time zone. <br />This field provides context regarding the geographical area in which the time zone is observed.
    - `CountryCode` string, nullable — A two-letter code (ISO 3166-1 alpha-2) that uniquely identifies the country associated with the time zone. <br />This code is useful for referencing countries in a standardised form
    - `UTCOffset` string, nullable — The offset of the time zone from Coordinated Universal Time (UTC), expressed in hours and minutes. <br />This value indicates how far behind or ahead the time zone is from UTC, which is essential for time calculations.
  - `TotalCount` integer, required — An integer representing the total number of time zones matching the search criteria, regardless of pagination. <br />This information is useful for understanding the full scope of available results.

## Other responses

- `400` — Invalid request response.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — The country code does not exist.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)