Documentation
Learn TicketsX faster
Setup guides, the full command reference, Premium features, and the REST API in one place.
List Tickets
GET
/<guild_id>/api/ticketsRetrieve a list of open tickets for the guild. Supports optional query filters to narrow results by claim status, user, or creator.
Query Parameters
| 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"