Support
Support ticket API: list Xquik tickets & status
List up to 200 Xquik support tickets in recent-update order. Review each ticket ID, subject, status, message count, creation time & latest update timestamp.
- 200
- 400
- 401
- 429
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
- Call
GET /support/ticketswith one Xquik API key. - Save the returned
publicIdandupdatedAtvalues. - Keep the response order for a recent-activity queue.
- Compare each
messageCountwith your previous list. - Fetch ticket details when the count or timestamp changes.
- Read each message and attachment status before replying.
- Update the ticket only after confirming the intended state.
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.
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 returnsmessageCount, 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 bysubject in your client.
Can I filter tickets by status?
The endpoint accepts no status query. Filteropen, in_progress, resolved,
or closed after receiving the list.
Which ticket should I read first?
Start with the first changed ticket. Results already use descendingupdatedAt order.
Does listing tickets consume Xquik credits?
No. Listing support tickets is free for authenticated accounts.Headers
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
cursor is not one this list returned. Send the nextCursor of the previous page, or omit it.
401 Unauthenticated
429 Rate limited
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.