v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB
Ticket API

Search Tickets

Search tickets with filters. Supports filtering by team, assignment, status, escalation level, and time range.

post/v2/tickets/search

Request body

teamIdsstring[]

Optional. Filter to specific teams. If not provided, searches all accessible teams.

assignedToUserIdsstring[]

Optional. Only return tickets assigned to any of these users.

requesterUserIdsstring[]

Optional. Only return tickets requested by any of these users.

statusIdsstring[]

Optional. Filter by status IDs. Returns tickets matching ANY of the specified statuses.

escalationLevelsSvhelpModelsTicketEscalationLevel[]

Optional. Filter by escalation levels. Returns tickets matching ANY of the specified levels.

createdAfterstring date-time

A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").

createdBeforestring date-time

A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").

pageSizeinteger nullable

Maximum number of results to return. Default is 1000, maximum is 5000.

pageTokenstring nullable

Token for pagination. Leave empty for the first request.

Response

Success

nextPageTokenstring nullable

Token for retrieving the next page of results. Empty if no more results.