List support tickets
GET /api/v2/support/tickets
Lists the support tickets on your Hostup account, newest activity first. Each row has the subject, status, priority, department, dates, message count and linked services. The rows leave out the messages. Read one ticket with GET /api/v2/support/tickets/{id} to get the conversation.
Authentication: An API key with the scope read:support. About keys and scopes
Request
Query parameters
limitintegerTickets per page, 1 to 100. Default 20. A larger value returns 100 tickets per page. A value below 1 becomes 20. Default
20. 1 to 100.cursorstringThe
nextCursor value from the previous page. A cursor the list cannot read returns the first page, with no error.statusstringOnly tickets with this status. An unknown value returns 400
invalid_request. One of open, answered, customer_reply, in_progress, on_hold, closed.departmentSlugstringOnly tickets in this department. Take the slug from
GET /api/v2/support/departments.Example
curl "https://cloud.hostup.se/api/v2/support/tickets" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 A page of support tickets.
{ "data": [ { "id": "tkt_01hxa3b4c5d6e7f8g9h0j1k2m3", "number": "149943", "subject": "Question about my hosting account", "status": "answered", "priority": "low", "departmentSlug": "general-web-hosting", "departmentName": "General - Web hosting", "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": "hosting", "serviceId": "acct_01hxa3b4c5d6e7f8g9h0j1k2m3", "serviceName": "example.com", "details": { "status": "Active", "hostname": "example.com", "nextDueAt": "2026-04-27T12:34:56.000Z" } } ] } ], "hasMore": false, "nextCursor": null}Response fields
dataarray of objectidstringnumberstringThe ticket number shown to the customer, usually digits. The ticket ID is
id.subjectstring or nullstatusstringOne 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 nullhasMorebooleannextCursorstring or nullErrors
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. |
| 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. |