GET
/ticketsList tickets
Returns tickets for the workspace (a team-role API key sees every ticket). Requires a team-role API key.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
type | query | "customer" | "back_office" | "tracker" | Filter by ticket type |
ticketTypeId | query | string | Filter by registry ticket-type ID (see the ticketType field on tickets) |
statusCategory | query | "open" | "pending" | "closed" | Filter by internal status category |
stage | query | "received" | "in_progress" | "awaiting_requester" | "resolved" | Filter by customer-facing public stage |
requesterPrincipalId | query | string | Filter by requester principal ID |
companyId | query | string | Filter by company ID |
sort | query | "recent" | "oldest" | "created" | "priority" | Sort order(default: recent) |
limit | query | integer | Items per page (max 100)(default: 20) |
Response
List of tickets
Returns an array of objects:
| Field | Type | Description |
|---|---|---|
idrequired | string | TypeID - a type-prefixed UUID |
numberrequired | number | Per-workspace sequential ticket number |
referencerequired | string | Human reference, "#" + number |
typerequired | "customer" | "back_office" | "tracker" | Ticket object type |
ticketTyperequired | object | null | Workspace-defined registry type, null on legacy typeless tickets |
titlerequired | string | |
statusrequired | object | Internal workspace status: its display name + stable category |
stagerequired | "received" | "in_progress" | "awaiting_requester" | "resolved" | null | Customer-facing public stage, null when the status projects none |
priorityrequired | "none" | "low" | "medium" | "high" | "urgent" | Triage priority |
requesterPrincipalIdrequired | string | null | Principal ID of the requester, null if unattributed |
assigneePrincipalIdrequired | string | null | Principal ID of the assigned teammate, null if unassigned |
assigneeTeamIdrequired | string | null | ID of the assigned team, null if unassigned |
companyIdrequired | string | null | ID of the associated company, null if none |
firstResponseAtrequired | string | null | When a teammate first responded, null until then |
dueAtrequired | string | null | SLA due time, null if no policy applies |
resolvedAtrequired | string | null | When the ticket entered a closed status, null while open |
createdAtrequired | string | ISO 8601 timestamp |
updatedAtrequired | string | ISO 8601 timestamp |
reopenedCountrequired | number | How many times the ticket has reopened |
meta
| Field | Type | Description |
|---|---|---|
paginationrequired | object |
Errors
401UnauthorizedExample request
curl \
"https://feedback.quackback.io/api/v1/tickets" \
-H "Authorization: Bearer qb_your_api_key_here"