Skip to content
/
Get country timezones
Last updated
GET/v1/reference/countries/{country_id}/timezones

Get timezones for a specific country.

Returns the active timezones associated with the given country, ordered by display order. Use this endpoint when a user selects a country in the UI to pre-populate or filter the timezone picker to only show relevant options.

Path Parameters

country_id string required

The country ID (e.g., country_f74b54afbfb441748e5ab747d0466144). Retrieve country IDs from Get Countries.

Returns

Returns an array of timezone objects for the given country. Returns an empty array if the country has no associated timezones. Returns a 404 error if the country ID does not exist.

cURL
curl https://api.aitronos.com/v1/reference/countries/country_f74b54afbfb441748e5ab747d0466144/timezones \
  -H "X-API-Key: $FREDDY_API_KEY"

Response

200 OK
[
  {
    "id": "tz_aae27d5eda834851a3c16a01d795c6b0",
    "name": "America/Anchorage",
    "display_name": "Alaska Time",
    "offset": "-09:00",
    "offset_minutes": -540,
    "country_code": "US",
    "is_active": true,
    "order": 11,
    "created_at": "2026-02-24T15:22:34.408321Z",
    "updated_at": "2026-02-24T15:22:34.408321Z"
  },
  {
    "id": "tz_32e5a65413864b41a815af9132c32b17",
    "name": "America/Los_Angeles",
    "display_name": "Pacific Time (US & Canada)",
    "offset": "-08:00",
    "offset_minutes": -480,
    "country_code": "US",
    "is_active": true,
    "order": 17,
    "created_at": "2026-02-24T15:22:34.408338Z",
    "updated_at": "2026-02-24T15:22:34.408338Z"
  },
  {
    "id": "tz_7a80838e35a54d4faea77b5dcd6a832e",
    "name": "America/New_York",
    "display_name": "Eastern Time (US & Canada)",
    "offset": "-05:00",
    "offset_minutes": -300,
    "country_code": "US",
    "is_active": true,
    "order": 19,
    "created_at": "2026-02-24T15:22:34.408343Z",
    "updated_at": "2026-02-24T15:22:34.408343Z"
  }
]
404 Not Found
{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "The requested resource could not be found.",
    "type": "client_error",
    "status": 404,
    "details": {
      "country_id": "country_doesnotexist"
    },
    "trace_id": "d5e1f4fd-2a95-4be4-aedb-fb34adad6a82",
    "timestamp": "2026-02-25T02:48:34.892612Z",
    "system_message": "The requested resource could not be found."
  }
}
Previous page
Next page