List Timezones

Retrieve a paginated list of the timezones you can assign to a contact.

The list is the same for every account. Use it to find the timezone_uuid to set on a contact when you create, upsert, or update one, or to filter contacts by timezone on List Contacts. Results are ordered by region, then by city.

Request

GET /timezones

Query Parameters

All parameters are optional.

Parameter	Type	Default	Description
page	integer	1	Page number (min: 1)
per_page	integer	100	Items per page (min: 1, max: 100)
search	string	-	Case-insensitive substring match over the timezone name, region, and city. For example, war matches Europe/Warsaw (max 255 characters).
region	string	-	Exact region match, e.g. Europe (max 64 characters). An unknown region returns an empty page.

search and region combine with AND.

Example Request

curl -X GET "https://email.easy.tools/api/v1/timezones?region=Europe" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Find a timezone by name:

curl -X GET "https://email.easy.tools/api/v1/timezones?search=warsaw" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response

Success Response (200 OK)

{
  "data": [
    {
      "uuid": "a1c4e2f8-3b6d-4f9a-8c2e-1d5b7a9c3e0f",
      "iana": "Europe/Amsterdam",
      "region": "Europe",
      "city": "Amsterdam"
    },
    {
      "uuid": "5f0b2d7c-9e14-4a83-b6d1-2c8f4e6a0b35",
      "iana": "Europe/Berlin",
      "region": "Europe",
      "city": "Berlin"
    },
    {
      "uuid": "748ff067-d041-4a2f-a7ad-a6f7ce049cdf",
      "iana": "Europe/Warsaw",
      "region": "Europe",
      "city": "Warsaw"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 100,
    "total": 3
  }
}

Response Fields

Each entry in data has the fields described in Timezone Object.

Pagination Object

Field	Type	Description
current_page	integer	Current page number
per_page	integer	Number of items per page
total	integer	Total number of matching timezones

Error Responses

Validation Error (422 Unprocessable Entity)

Returned when page or per_page is out of range.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The given data was invalid",
    "details": {
      "per_page": ["The per page field must not be greater than 100."]
    }
  }
}