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](/docs/api-reference/reference/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.


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


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
country_id = "country_f74b54afbfb441748e5ab747d0466144"
response = requests.get(
    f"https://api.aitronos.com/v1/reference/countries/{country_id}/timezones",
    headers={"X-API-Key": api_key}
)
timezones = response.json()
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;
const countryId = "country_f74b54afbfb441748e5ab747d0466144";
const response = await fetch(
  `https://api.aitronos.com/v1/reference/countries/${countryId}/timezones`,
  {
    headers: {
      'X-API-Key': apiKey
    }
  }
);
const timezones = await response.json();
```

## Response


```json 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"
  }
]
```


```json 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."
  }
}
```

## Related Resources

- [Get Countries](/docs/api-reference/reference/countries)
- [Get Timezones](/docs/api-reference/reference/timezones)