Get a support ticket
GET /api/v2/support/tickets/{id}
Returns one support ticket with the whole conversation. body is the opening message and attachments are the files sent with it. messages holds the replies, oldest first, each with its own attachments. Download a file through its downloadUrl.
{id} also accepts the ticket number.
Authentication: An API key with the scope read:support. About keys and scopes
Request
Path parameters
idstringrequiredThe ticket ID (
tkt_…) or the ticket number.Example
curl "https://cloud.hostup.se/api/v2/support/tickets/tkt_01hxa3b4c5d6e7f8g9h0j1k2m3" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 The ticket with its messages.
{ "id": "tkt_01hxa3b4c5d6e7f8g9h0j1k2m3", "number": "930734", "subject": "Question about my domain", "body": "I need help updating my domain nameservers.", "status": "answered", "priority": "low", "departmentSlug": "domain-names", "departmentName": "Domain names", "createdAt": "2026-04-27T11:45:00.000Z", "updatedAt": "2026-04-27T12:05:00.000Z", "lastMessageAt": "2026-04-27T12:05:00.000Z", "ccEmails": [], "requesterName": "Jane Example", "messageCount": 2, "linkedServices": [ { "serviceType": "domain", "serviceId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3", "serviceName": "example.com", "details": { "status": "Active", "autoRenew": true } } ], "attachments": [], "messages": [ { "id": "tmsg_01hxa3b4c5d6e7f8g9h0j1k2m4", "ticketId": "tkt_01hxa3b4c5d6e7f8g9h0j1k2m3", "sentAt": "2026-04-27T12:05:00.000Z", "body": "We have checked the domain and replied with the next steps.", "sender": "staff", "senderName": "Support Team", "encrypted": false, "attachments": [] } ]}Response fields
idstringnumberstringThe ticket number shown to the customer, usually digits. The ticket ID is
id.subjectstring or nullbodystring or nullPresent only on the ticket detail and on the create response.
statusstringOne of
open, answered, customer_reply, in_progress, on_hold, closed, unknown.prioritystringOne of
low, medium, high, urgent, critical.departmentSlugstringdepartmentNamestring or nullcreatedAtstring or nullupdatedAtstring or nulllastMessageAtstring or nullccEmailsarray of stringrequesterNamestring or nullmessageCountintegerlinkedServicesarray of objectserviceTypestringserviceIdstring or nullserviceNamestring or nulldetailsobject or nullattachmentsarray of objectPresent only on the ticket detail and on the create response.
idstringfilenamestring or nullextensionstring or nullmimeTypestring or nulldownloadUrlstringmessagesarray of objectPresent only on the ticket detail and on the create response.
idstringticketIdstringsentAtstring or nullbodystring or nullsenderstringOne of
customer, staff, automation.senderNamestring or nullencryptedbooleanattachmentsarray of objectErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is ticket_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |
| 502 | Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists. |