Skip to main content

Search tickets

Searches tickets using a compact query string. Supported operators: type:ticket (no-op), status:<value> (exact status), and status<<value> (every status ordered before the given one). Unknown operators are ignored. Results are paginated 100 per page.

Query Parameters
bot string REQUIRED

The unique ID of the bot.

query string

Search query, e.g. type:ticket status<solved or status:open.

page integer

Zero-based page number (100 tickets per page).

Responses
200

Matching tickets returned.

Schema OPTIONAL
tickets object[] OPTIONAL
total integer OPTIONAL
count integer OPTIONAL
next_page integer OPTIONAL
previous_page integer OPTIONAL
401

Missing/invalid API key.

Schema OPTIONAL
error string OPTIONAL

Human-readable error message.

429

Rate limit exceeded.

Schema OPTIONAL
error string OPTIONAL

Human-readable error message.

500

Internal server error.

Schema OPTIONAL
error string OPTIONAL

Human-readable error message.