--- title: "Read more of a request's timeline" method: GET path: "/hd/desks/{desk_id}/tickets/{number}/events" tags: ["hd"] --- # Read more of a request's timeline `GET /hd/desks/{desk_id}/tickets/{number}/events` ## Request - Base URL: `https://api.sparkvault.com/v1` - URL: `https://api.sparkvault.com/v1/hd/desks/{desk_id}/tickets/{number}/events` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) The next page of a request's timeline, from the cursor the previous page answered. ## Path parameters - `desk_id` string, required - `number` string, required ## Query parameters - `cursor` string ## Headers - `X-SV-Client` 'help-desk-portal', required ## Response `200` A page of the timeline. - object - `data` HelpDeskCustomerTimelinePage, required - `events` HelpDeskCustomerEvent[], required - `event_id` string, required - `seq` integer, required: Orders the request's events: one that came later carries a larger `seq`. - `type` 'ticket_created' | 'customer_message' | 'operator_reply' | 'status_changed' | 'reopened' | 'resolved_by_customer' | 'merged_into' | 'merged_from', required - `created_at` integer, required: Epoch seconds. - `actor` object, required - `kind` 'customer' | 'operator' | 'system' | 'rule', required - `label` string, nullable, required: The name the desk shows the actor by. - `avatar_handle` string, nullable, required: An operator's avatar address on the desk (GET /hd/desks/{desk_id}/avatars/{avatar_handle}); null for none. - `body` object, nullable, required: A message's text, as its safe-markup document (`@sparkvault/app-sdk/safe-markup`); null for an event that carries no message, and for a message that cannot be read right now. - `attachments` object[], required - `attachment_id` string, required - `name` string, required - `size` integer, required: Bytes. - `disposition` 'inline' | 'attachment', required: How a browser is handed the file: inline only for a type Chrome and Firefox both show as a page from a single-use link (a JPEG, PNG, GIF, WebP, AVIF or BMP image, or a PDF); anything else downloads, every recording included. - `scan` 'pass' | 'not_scanned', required: `pass` when the mail scan passed the email that brought the file; `not_scanned` for an upload, and for an email part the scan could not judge. - `status` object: On a status change: the status the request moved from and to. - `from` string, nullable - `to` string, nullable - `merged` object: On a merge: the number of the other request. - `number` integer, nullable - `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 — the cursor is not one this request's timeline gave. 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. - `404`: NOT_FOUND — no such request, draft or file is the customer's: one that does not exist and one of another customer read the same, byte for byte. - `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`: 20 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 `404` - the response property `error/details` became required for the status `429` - …16 more - **2026-10-28** `56d7c265a77a`: 5 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 `404` - the response property `error/details` became nullable for the status `429` - …1 more - **2026-10-28** `fecd5111028e`: 2 warning - added the new `not_scanned` enum value to the `data/events/items/attachments/items/scan` response property for the response status `200` - added the new `pass` enum value to the `data/events/items/attachments/items/scan` response property for the response status `200` - **2026-10-23** `ad4c62db5e08`: 1 info - endpoint added [Operation history](https://skmtc.dev/sparkvault/apis/sparkvault-api/changes/hd/desks/:desk_id/tickets/:number/events/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)