List user time frame names

GET

/domains/{domain}/users/{user}/timeframes/list

Last modified:2026-10-09 00:47:30

OperationId:ListUserTimeframes

Returns the name and state of each time frame the user owns: whether an answer rule of the user uses it (selected) and whether every range in it is in the past (expired). It does not include the domain's shared time frames; list those with GET /domains/{domain}/timeframes/list. Requires the list privilege on time frames, which Basic User, Site Manager, and Office Manager hold in their domain, and Reseller and Super User more widely. The owner must be one you can reach, or the call returns 403.

/list is a suffix on the collection path. It returns names and state only, and it is authorised by the list privilege, the one /count uses. On a keyed path, /timeframes/{id}/list, it returns only that time frame, by ID or by name. Changed in v46: rows used to be name strings with the state appended; they are now objects with selected and expired fields.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200Success

application/json

One row per time frame, sorted by name. None returns [].

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//timeframes/list' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Names

One time frame, in use by an answer rule.

[
    {
        "timeframe": "Business Hours",
        "domain": "example.com",
        "user": "1001",
        "selected": "yes",
        "expired": "no"
    }
]

Modified at 2026-10-09 00:47:30

Read user time frame

List holiday countries