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 - does not consume credits

Read the support ticket inventory

Use the list as a compact 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. The request has no pagination, search, or status query parameter. Ask support when you need an older ticket. 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 inventory.
  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. These routes preserve 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 inventory during that pause.

Answer support ticket API questions

Does the list include ticket messages?

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

Does the list include attachments?

The current 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.

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.

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.