Documentation

Learn TicketsX faster

Setup guides, the full command reference, Premium features, and the REST API in one place.

13.2

List Tickets

GET/<guild_id>/api/tickets

Retrieve a list of open tickets for the guild. Supports optional query filters to narrow results by claim status, user, or creator.

Name	Type	Required	Description
filter	string	optional	Filter tickets by status. Accepted values: `claimed`, `mine`.
user_id	string	optional	Filter tickets where this user is a participant.
creator_id	string	optional	Filter tickets created by this user ID.
limit	number	optional	Page size, 1-100 (default 50).
offset	number	optional	Number of results to skip for pagination (default 0).

Responses include a pagination object: { total, limit, offset, returned }. Only open tickets are returned.

Example request

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/tickets?filter=claimed&creator_id=123456789"