--- title: "List the customer's requests" method: GET path: "/hd/desks/{desk_id}/tickets" tags: ["hd"] --- # List the customer's requests `GET /hd/desks/{desk_id}/tickets` ## Request - Base URL: `https://api.sparkvault.com/v1` - URL: `https://api.sparkvault.com/v1/hd/desks/{desk_id}/tickets` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) The customer's own requests, a page at a time: the open ones, or the closed ones. With `number`, the one request of the customer's that number names, whatever its status, or none. ## Path parameters - `desk_id` string, required ## Query parameters - `status` 'open' | 'closed' - `number` integer - `cursor` string ## Headers - `X-SV-Client` 'help-desk-portal', required ## Response `200` A page of the customer's requests. - object - `data` object, required - `items` HelpDeskCustomerTicket[], required - `number` integer, required: The request's number at the desk: every route names the request by it. - `subject` string, required - `status` 'open' | 'waiting_on_customer' | 'on_hold' | 'closed', required - `close_reason` 'resolved' | 'duplicate' | 'null', nullable, required: Why a closed request closed: resolved, or merged into another request (duplicate); null for one that is not closed, and for one closed for a reason its customer is not shown. - `awaiting_first_response` boolean, required: True until the desk first answers the request. - `created_at` integer, required: Epoch seconds the request was opened. - `last_public_activity_at` integer, nullable, required: Epoch seconds the request last changed in a way its customer sees; null when the answer does not say. - `muted` boolean, required: True while the request's update emails are turned off. - `feedback` HelpDeskCustomerFeedback: One current rating per request. The first vote freezes its public reply, author and reporting day; later changes replace that sample. - `eligible` boolean, required: Whether this request has an eligible published operator reply and accepts feedback. - `lookup_complete` boolean, required: False when the bounded legacy reply lookup could not finish. The ticket remains readable, but feedback is temporarily unavailable rather than reported as unrated. - `rating` 'positive' | 'negative' | 'null', nullable, required - `submitted_at` integer, nullable, required: First submission time; subsequent vote changes keep the original reporting day. - `updated_at` integer, nullable, required - `version` integer, required: Zero when unrated; increments only when the saved rating changes, including within the same second. - `reply_event_id` string, nullable, required: The public operator reply being rated. Existing feedback keeps its original reply. - `destination_url` string, uri, nullable, required: The configured HTTPS follow-up link for the saved rating, or null. Never supplied by the customer or populated before a vote is saved. - `can_resolve` boolean: On the request's own page (GET /hd/desks/{desk_id}/tickets/{number}) alone: whether the customer may mark the request resolved now. A list of requests does not carry it. - `next_cursor` string, nullable, required: Opaque continuation token. Null when the listing is exhausted. - `meta` ResponseMeta: Envelope metadata present on every successful response. - `api_version` string - `request_id` string - `response_ms` integer - `timestamp` integer: Unix seconds. - `pools` object: Storage and bandwidth capacity snapshot for the account. - `billing` object - `past_due` boolean - `quota` object: This minute of the account request budget. Present on authenticated success responses that passed the throttle; absent otherwise. - `limit` integer - `used` integer - `remaining` integer - `resets_at` integer: Unix seconds. ## Other responses - `400`: VALIDATION_ERROR — `status` is neither open nor closed, `number` is no request number, or the cursor is not one this list gave the customer. CLIENT_HEADER_REQUIRED — see above. - `401`: CUSTOMER_AUTH_REQUIRED — no bearer token, or one that is not a customer's of this desk now: unknown, expired, revoked, another desk's, or of the sign-in mode the desk no longer uses. - `429`: RATE_LIMIT_EXCEEDED — this client address, or this customer, has spent its reads at the desk for the minute, or the request would make a Secure Identity customer's record past the new customers the desk takes in an hour. `Retry-After` carries the seconds until the budget reopens, and `details` carries `limit` and `resets_at`. - `503`: HELP_DESK_UNAVAILABLE — the desk does not take customers right now, or this customer is refused. INTERNAL_ERROR — the identity service's keys could not be read to verify a Secure Identity bearer. BUDGET_UNAVAILABLE — a budget the request spends could not be counted, so the request was refused rather than let through uncounted; `Retry-After` carries the seconds to wait before trying again. ## Changes - **2026-10-28** `a9a10e328ba5`: 16 info - the response property `error/details` became required for the status `400` - the response property `error/details` became required for the status `401` - the response property `error/details` became required for the status `429` - the response property `error/details` became required for the status `503` - …12 more - **2026-10-28** `56d7c265a77a`: 4 breaking - the response property `error/details` became nullable for the status `400` - the response property `error/details` became nullable for the status `401` - the response property `error/details` became nullable for the status `429` - the response property `error/details` became nullable for the status `503` - **2026-10-27** `ac44ec1f8cfa`: 1 info - added the optional property `data/items/items/feedback` to the response with the `200` status - **2026-10-23** `ad4c62db5e08`: 1 info - endpoint added [Operation history](https://skmtc.dev/sparkvault/apis/sparkvault-api/changes/hd/desks/:desk_id/tickets/get.md) --- [API](https://skmtc.dev/sparkvault/apis/sparkvault-api.md) - [All operations](https://skmtc.dev/sparkvault/apis/sparkvault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sparkvault/apis/sparkvault-api/revisions/97cfadccd0c0?raw)