Skip to main content
GET https://xquik.com/api/v1/support/tickets

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 10,000 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. These local queue categories are useful.
  • 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

Query parameters

Response

200 OK

400 Invalid cursor

{ "error": "invalid_input", "message": "Cursor invalid. Use nextCursor from the previous page, or omit it to start over." } 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

{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 1 } Wait for the Retry-After value before listing tickets again.
Related.

Response examples

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }