Skip to main content
GET
Search tickets

Authorizations

X-Initdesk-Token
string
header
required

Path Parameters

organization_id
string
required

Query Parameters

assignee
integer

Filter tickets assigned to the given organization user ID.

channel
string

Filter by conversation channel type (e.g. email).

custom_preset_filter
string

Apply a saved custom preset filter by UUID. Integration tokens may only use organization-shared filters.

email
string

Filter by customer email (case-insensitive exact match).

is_spam
boolean

When omitted defaults to false. Pass true to include only spam tickets. Accepted values: true, false (case-insensitive).

page
integer

A page number within the paginated result set.

page_size
integer

Number of results to return per page.

preset_filter
enum<string>

Apply a predefined filter. Allowed values: needs_attention, focused

Available options:
focused,
needs_attention
query
string

Full-text search query. Alias for search.

tags
string[]

Filter by tag name (case-insensitive). Repeat the parameter to match tickets with any of the listed tags (e.g. ?tags=urgent&tags=vip).

waiting_on
enum<string>

Filter by waiting_on status.

Available options:
,
associate,
customer

Response

200 - application/json
count
integer
required
Example:

123

results
object[]
required
next
string<uri> | null
Example:

"http://api.example.org/accounts/?page=4"

previous
string<uri> | null
Example:

"http://api.example.org/accounts/?page=2"