Skip to main content
GET
Error

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
ORG-ID
string
header
required

Path Parameters

​
project_id
string<uuid>
required

Query Parameters

​
page
integer

Page number (1-based). If omitted and offset is set, page is derived as offset/limit + 1.

Required range: x >= 1
​
limit
integer
​
offset
integer

Legacy offset; used only when page is omitted.

​
ids
string

Comma-separated ticket UUIDs; list is restricted to these ids (invalid tokens return 400).

​
workflow_version_id
string<uuid>
​
state_label_id
string<uuid>

Filter by a single persisted state label row UUID.

​
labels
string

Comma-separated workflow state label keys (OR). Matching ignores case and non-alphanumeric separators (underscore, space, hyphen), so mat_loss matches MAT LOSS and matloss. MattLoss folds to mattloss and does not match mat_loss.

​
system_class
enum<string>
Available options:
open,
in_progress,
terminal_success,
terminal_failed,
cancelled
​
assigned_group_id
string<uuid>
​
title_search
string

Substring match on title (ignored if fewer than 3 characters, same pattern as device name search).

​
tag_kind
string

When set (with optional tag_value), only tickets having at least one tag with this kind are returned.

​
tag_value
string

Optional; when set with tag_kind, tag value must match exactly.

​
fields
string

Comma-separated allowlisted field names for each item. Base ticket keys (e.g. id, title, system_class) plus expansions tags (array) and state_label (object). Unknown names return 400. When omitted, each item is the full ticket object.

Response

Tickets loaded

​
data
object
required
​
ok
enum<integer>
required
Available options:
1