Ticket API

Search Tickets

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

post/v2/tickets/search

Request

Base URL
https://public.api.serval.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/serval/apis/serval-public-api/docs/v2/tickets/search/post.ts
A function with typed inputs. Its response is checked against the schema.

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.

Success

nextPageTokenstring nullable

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

No recorded changes to this operation across all 1 revision of this API.