Skip to content

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

idstringrequired
The ticket ID (tkt_…) or the ticket number.

Example

GET /api/v2/support/tickets/{id}
curl "https://cloud.hostup.se/api/v2/support/tickets/tkt_01hxa3b4c5d6e7f8g9h0j1k2m3" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 The ticket with its messages.

Response 200
{
"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
idstring
numberstring
The ticket number shown to the customer, usually digits. The ticket ID is id.
subjectstring or null
bodystring or null
Present only on the ticket detail and on the create response.
statusstring
One of open, answered, customer_reply, in_progress, on_hold, closed, unknown.
prioritystring
One of low, medium, high, urgent, critical.
departmentSlugstring
departmentNamestring or null
createdAtstring or null
updatedAtstring or null
lastMessageAtstring or null
ccEmailsarray of string
requesterNamestring or null
messageCountinteger
linkedServicesarray of object
serviceTypestring
serviceIdstring or null
serviceNamestring or null
detailsobject or null
attachmentsarray of object
Present only on the ticket detail and on the create response.
idstring
filenamestring or null
extensionstring or null
mimeTypestring or null
downloadUrlstring
messagesarray of object
Present only on the ticket detail and on the create response.
idstring
ticketIdstring
sentAtstring or null
bodystring or null
senderstring
One of customer, staff, automation.
senderNamestring or null
encryptedboolean
attachmentsarray of object

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller; code is ticket_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.
502Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists.