List support tickets

GET /api/v2/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

Authenticate with an API key in the Authorization: Bearer <token> header.

Context

Query Parameters

limit integer · min: 1 · max: 100 · default: 20

Page size from 1 to 100. Defaults to 20.

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

Authorization Bearer <token>
Accept application/json

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 string · nullable required · Example: Question about my VPS

Nullable: may be null when not applicable.

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 string · nullable required · Example: Billing

Nullable: may be null when not applicable.

data[].createdAt string · nullable required · Example: 2026-04-27T11:45:00.000Z

Nullable: may be null when not applicable.

data[].updatedAt string · nullable required · Example: 2026-04-27T12:05:00.000Z

Nullable: may be null when not applicable.

data[].lastMessageAt string · nullable required · Example: 2026-04-27T12:05:00.000Z

Nullable: may be null when not applicable.

data[].ccEmails array<string> required · Example: ["ops@example.com"]
data[].requesterName string · nullable required · Example: Jane Example

Nullable: may be null when not applicable.

data[].messageCount integer required · Example: 2
data[].linkedServices array<object> required
data[].linkedServices[].serviceType string required · Example: vps
data[].linkedServices[].serviceId string · nullable required · Example: vps_01hxa3b4c5d6e7f8g9h0j1k2m3

Nullable: may be null when not applicable.

data[].linkedServices[].serviceName string · nullable required · Example: app-01

Nullable: may be null when not applicable.

data[].linkedServices[].details object · nullable required · Example: {"status":"active","planName":"VPS XS","ipAddress":"192.0.2.10"}

Nullable: may be null when not applicable.

hasMore boolean · Example: false
nextCursor string · nullable · 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"
          }
        }
      ]
    }
  ],
  "hasMore": false,
  "nextCursor": null
}