v1

latestSwagger 2.02026-08-06115129197.7 KB
Tickets

Query for tickets

Returns all tickets based on query criteria

get/tickets

Query parameters

location_mytime_idinteger

Location MyTime ID by which to filter results - Optional

{"stackTrail":"paths:/tickets:get:parameters:3:schema","oasType":"schema","type":"unknown"}

The ticket creation (or closed at for closed tickets query) filter start date e.g.: 2020-10-22

{"stackTrail":"paths:/tickets:get:parameters:4:schema","oasType":"schema","type":"unknown"}

The ticket creation (or closed at for closed tickets query) filter end date e.g.: 2020-10-22.

closedboolean

Return closed tickets. If false, will return all tickets.

client_mytime_idinteger

Client MyTime ID by which to filter results - Optional

pageinteger

Pagination - results page number to retrieve

per_pageinteger

Pagination - number of results per per_page. Default: 20. Maximum: 20

sort'closed_or_created_at' | 'closed_at'

Default is ascending ticket id. Pass 'closed_at' (fastest, requires closed=true — the default) to order by close time, or 'closed_or_created_at' to order by closed_at falling back to created_at for tickets that are not closed. Newest first unless sort_order=asc. When sort is passed without a page parameter, the response includes an after_cursor for cursor-based pagination.

sort_order'asc' | 'desc'

Direction for the sort parameter: 'desc' (newest first, the default) or 'asc' (oldest first). Requires sort.

after_cursorstring

Cursor-based pagination: pass the after_cursor value returned by the previous page to fetch the next one. Requires the sort parameter. When present, page is ignored. The response omits after_cursor on the last page. Recommended for sync integrations over page-based pagination — tickets closed while paging are never skipped. The cursor is a timestamp (start with a sorted request and no page parameter to get the first cursor), advances in the sort_order direction, and a page boundary may repeat a ticket (dedupe by id).

Headers

X-Subdomainstring

Merchant subdomain - Optional

X-Partnerstring

Partner key - Optional

Response

Tickets response

countinteger
after_cursorstring