Skip to content
Navigation
GET/tickets

List tickets

Returns tickets for the workspace (a team-role API key sees every ticket). Requires a team-role API key.

Parameters

NameInTypeDescription
typequery"customer" | "back_office" | "tracker"Filter by ticket type
ticketTypeIdquerystringFilter by registry ticket-type ID (see the ticketType field on tickets)
statusCategoryquery"open" | "pending" | "closed"Filter by internal status category
stagequery"received" | "in_progress" | "awaiting_requester" | "resolved"Filter by customer-facing public stage
requesterPrincipalIdquerystringFilter by requester principal ID
companyIdquerystringFilter by company ID
sortquery"recent" | "oldest" | "created" | "priority"Sort order(default: recent)
limitqueryintegerItems per page (max 100)(default: 20)

Response

List of tickets

Returns an array of objects:

FieldTypeDescription
idrequiredstringTypeID - a type-prefixed UUID
numberrequirednumberPer-workspace sequential ticket number
referencerequiredstringHuman reference, "#" + number
typerequired"customer" | "back_office" | "tracker"Ticket object type
ticketTyperequiredobject | nullWorkspace-defined registry type, null on legacy typeless tickets
titlerequiredstring
statusrequiredobjectInternal workspace status: its display name + stable category
stagerequired"received" | "in_progress" | "awaiting_requester" | "resolved" | nullCustomer-facing public stage, null when the status projects none
priorityrequired"none" | "low" | "medium" | "high" | "urgent"Triage priority
requesterPrincipalIdrequiredstring | nullPrincipal ID of the requester, null if unattributed
assigneePrincipalIdrequiredstring | nullPrincipal ID of the assigned teammate, null if unassigned
assigneeTeamIdrequiredstring | nullID of the assigned team, null if unassigned
companyIdrequiredstring | nullID of the associated company, null if none
firstResponseAtrequiredstring | nullWhen a teammate first responded, null until then
dueAtrequiredstring | nullSLA due time, null if no policy applies
resolvedAtrequiredstring | nullWhen the ticket entered a closed status, null while open
createdAtrequiredstringISO 8601 timestamp
updatedAtrequiredstringISO 8601 timestamp
reopenedCountrequirednumberHow many times the ticket has reopened

meta

FieldTypeDescription
paginationrequiredobject

Errors

401Unauthorized

Example request

curl \
  "https://feedback.quackback.io/api/v1/tickets" \
  -H "Authorization: Bearer qb_your_api_key_here"