Get Support Ticket
GET/api/support/tickets/:ticket
Returns one support ticket, including its watchers/participants and the links visible to a customer (release notes and the record it was raised from — internal links like a bug tracker issue are agent-only).
support:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
first_response_sla_status and resolution_sla_status report the ticket's two SLA clocks: one of on_track, breaching_soon (past the policy's warning point, by default 75% of the way from creation to the due date), breached, paused (the ticket is waiting on the customer, so neither clock warns), met (responded / resolved before the due date). merged_into is {id, number} once the ticket has been merged into another, otherwise null.
A ticket belonging to another tenant — or a requester-only ticket you cannot see — returns 404, never 403.
work — how far along the ticket is, in customer wording (null only on a ticket raised before work tracking existed). It never says who works the ticket — the support team is always "SKU.io Support":
picked_up_at(ISO-8601, nullable) — when SKU.io Support first picked the ticket upstage(string) — one of: received, investigating, fixing, waiting_on_you, resolved (a ticket SKU.io Support has started on readsinvestigating— the customer is never told it was picked up, or by whom);stage_label(string) —Received,Picked up,Investigating,Working on a fix,Waiting on you,Resolvedworking_now(boolean) andactive_until(ISO-8601, nullable) — SKU.io Support is actively working the ticket right nowprogress_text(string, nullable) andprogress_at(ISO-8601, nullable) — the latest progress update
Who works the ticket, the internal working phase, the stale flag and approval cards are never part of the customer view.
category — what the ticket is about and why it was raised:
feature_key(string, nullable) — akeyfrom the categories list (a SKU.io feature,platform.otherornone); null while uncategorised.feature_labelis its display namearea/area_label(string, nullable) — the product area of that feature (null fornoneor while uncategorised)cause(string, nullable) — one of: how_to, configuration, defect, third_party, request, billing, data_process, other.cause_labelis its display namesource(string, nullable) — who set it:ai(suggested automatically when the ticket was triaged),customer(someone on the account) oragent(SKU.io Support);source_labelis the same in customer wordingsuspected_defect(boolean) — an automatic check suspected a bug that nobody has confirmed yet. It is never counted as a defect; only SKU.io Support (or an engineering link) makes a ticket a defectlocked(boolean) — true once SKU.io Support set the category; the customer can no longer change itset_at(ISO-8601, nullable) — when it was last set
Authentication: Bearer token with the support:read scope, or an authenticated session. Requires the X-Tenant-Id header (or a tenant subdomain).
environment says which SKU.io environment the ticket was raised on — production, or beta, demo or dev for one forwarded here by that environment's intake. origin_tenant_id and origin_host are the tenant and host it came from, and are null on a ticket raised in production.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthorized
Response Headers
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.