Skip to content

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

limitinteger
Tickets 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.
cursorstring
The nextCursor value from the previous page. A cursor the list cannot read returns the first page, with no error.
statusstring
Only tickets with this status. An unknown value returns 400 invalid_request. One of open, answered, customer_reply, in_progress, on_hold, closed.
departmentSlugstring
Only tickets in this department. Take the slug from GET /api/v2/support/departments.

Example

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

Responses

200 A page of support tickets.

Response 200
{
"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 object
idstring
numberstring
The ticket number shown to the customer, usually digits. The ticket ID is id.
subjectstring or null
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
hasMoreboolean
nextCursorstring or null

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.
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.