List support tickets

Return support ticket summaries visible to the account. Use data[].id from this endpoint to fetch details, add replies, close, or reopen a ticket. List summaries intentionally omit body, attachments, and messages; use GET /api/v2/support/tickets/{id} for the conversation.

Support Tickets

Authentication

Required API scope: read:support

Use Authorization: Bearer <token> for API keys. Dashboard sessions may also use hostup_session.

Context

Query Parameters

limit integer · min: 1 · max: 100

Maximum support tickets to return in this page.

cursor string

Opaque cursor from `nextCursor` for the next page.

status string · enum

Filter tickets by normalized status.

open
answered
customer_reply
in_progress
on_hold
closed
departmentSlug string · Example: general-web-hosting

Customer-facing support department slug. Discover valid values from GET /api/v2/support/departments; do not guess slugs from department names.

Headers

Accept Example
Content-Type Example

Responses

200 Cursor-paginated list.
data array<object>
data[].id string required · Example: tkt_01hxa3b4c5d6e7f8g9h0j1k2m3
data[].number string required · Example: 149943

Customer-facing support ticket number. Normally numeric; public IDs are exposed separately as id.

data[].subject stringnull required · Example: Question about my VPS
data[].status string · enum required · Example: open
open
answered
customer_reply
in_progress
on_hold
closed
unknown
data[].priority string · enum required · Example: low
low
medium
high
urgent
critical
data[].departmentSlug string required · Example: billing
data[].departmentName stringnull required · Example: Billing
data[].createdAt stringnull required · Example: 2026-04-27T11:45:00.000Z
data[].updatedAt stringnull required · Example: 2026-04-27T12:05:00.000Z
data[].lastMessageAt stringnull required · Example: 2026-04-27T12:05:00.000Z
data[].ccEmails array<string> required · Example: ["[email protected]"]
data[].requesterName stringnull required · Example: Jane Example
data[].messageCount integer required · Example: 2
data[].linkedServices array<object> required
data[].linkedServices[].serviceType string required · Example: vps
data[].linkedServices[].serviceId stringnull required · Example: vps_01hxa3b4c5d6e7f8g9h0j1k2m3
data[].linkedServices[].serviceName stringnull required · Example: app-01
data[].linkedServices[].details objectnull required · Example: {"status":"active","planName":"VPS XS","ipAddress":"192.0.2.10"}
hasMore boolean · Example: false
nextCursor stringnull · Example: null
400 Invalid request. The response body is an RFC 7807 Problem Details document.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
401 Unauthorized. Authentication is required.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
403 Forbidden. The caller lacks a required scope or does not own the resource.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
404 Not found. The resource does not exist or is not owned by the caller.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
429 Rate limited. Retry after the limit resets. 429 responses include `Retry-After` seconds plus `X-RateLimit-*` headers.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
500 Internal error. Retry later or contact support if the issue persists.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
GET https://cloud.hostup.se/api/v2/support/tickets
For AI assistants
View as Markdown
cURL 
curl -X GET "https://cloud.hostup.se/api/v2/support/tickets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response 
{
  "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",
            "autoRenew": true
          }
        }
      ]
    }
  ],
  "hasMore": false,
  "nextCursor": null
}