Skip to main content
GET
Support ticket API: list Xquik tickets & status

List support tickets for Xquik workflows

List the signed-in account’s Xquik support tickets. Review connection failures, tweet write errors, follower exports, monitor alerts, webhooks, or billing cases. This endpoint returns the documented ticket summary fields. Fetch Get Ticket when you need message bodies or attachment metadata.
Free. This endpoint does not consume credits.

Read the support ticket list

Use the list as a support queue. Store ticket IDs and timestamps before requesting any detailed history. The endpoint returns up to 200 tickets. It sorts the newest updatedAt value first. Pass nextCursor as cursor to read older tickets. The request has no search or status query parameter. Filter the returned array locally. Match publicId, subject, or status without sending another list request.

Interpret support ticket status

The support ticket API returns 4 status values. Listing tickets never changes any status. Users can set open, resolved, or closed through the update route. Support sets in_progress. Do not invent another state in client code.

Build a support ticket review queue

  1. Call GET /support/tickets with one Xquik API key.
  2. Save the returned publicId and updatedAt values.
  3. Keep the response order for a recent-activity queue.
  4. Compare each messageCount with your previous list.
  5. Fetch ticket details when the count or timestamp changes.
  6. Read each message and attachment status before replying.
  7. Update the ticket only after confirming the intended state.
Use Reply to Ticket for new investigation details. Use Update Ticket Status for workflow state changes. Both routes keep the existing ticket ID. Do not create a duplicate ticket for every retry. Reuse the original publicId while the subject describes the same problem.

Triage X API and Twitter scraper problems

Keep ticket subjects specific. Name the affected tweet, follower, monitor, webhook, X account, or billing workflow. Useful local queue categories include:
  • X account connection or reauthentication.
  • Tweet creation, deletion, reply, like, or repost actions.
  • Follower, following, timeline, reply, or media exports.
  • Keyword monitors, account monitors, and webhook deliveries.
  • API key authentication, credits, subscription checkout, or top-ups.
The list response does not explain the failure. Fetch the matching ticket before making a product decision. For a 429 response, wait for Retry-After. Reuse the last successful list during that pause.

Support ticket API questions

Does the list include ticket messages?

The response returns messageCount, not message text. Fetch the ticket by publicId to read its chronological conversation.

Does the list include attachments?

The response omits attachment filenames, types, sizes, states, and download URLs. Fetch the detailed ticket to inspect attachments.

Can I search support tickets by subject?

The endpoint accepts no search query. Filter the returned ticket summaries by subject in your client.

Can I filter tickets by status?

The endpoint accepts no status query. Filter open, in_progress, resolved, or closed after receiving the list.

Which ticket should I read first?

Start with the first changed ticket. Results already use descending updatedAt order.

Does listing tickets consume Xquik credits?

No. Listing support tickets is free for authenticated accounts.

Headers

string
Your Xquik API key. Generate one from the dashboard.
string
An OAuth bearer token formatted as Bearer YOUR_TOKEN. Send this header or x-api-key, not both.

Query parameters

integer
Maximum items per page: 1 to 200, default 200.
string
nextCursor from the previous page. The after alias also works. Offset pagination is not supported.

Response

200 OK

object[]
Array of ticket objects.
string
Unique ticket public ID.
string
Ticket subject.
string
Current status: open, in_progress, resolved, or closed.
number
Total number of messages in the ticket.
string
ISO 8601 creation timestamp.
string
ISO 8601 last update timestamp.
boolean
Whether more rows follow this page.
string
Pass it as cursor for the next page. Present when hasMore is true.

400 Invalid cursor

The cursor is not one this list returned. Send the nextCursor of the previous page, or omit it.

401 Unauthenticated

Missing or invalid API key.

429 Rate limited

Wait for the Retry-After value before listing tickets again.
Related. Create Ticket to open a new ticket, or Get Ticket to fetch details and message history for a specific ticket.