GET https://xquik.com/api/v1/draws/{id}
Retrieve one Twitter giveaway result with its draw ID. Inspect the source tweet
snapshot, candidate counts, timestamps, and ordered winner rows. Separate
primary winners from backup winners before publishing results.
This endpoint does not return create-time eligibility rules or exclusion
reasons. Keep the original POST /draws request when an audit needs those
rules.
Verify one Twitter giveaway draw
Use this route to review one completed or pending draw. Keep its draw ID with winner announcements, support records, and exports.Free. This endpoint does not consume credits.
Source tweet snapshot
Read the tweet ID, URL, text, author, and engagement counts captured for
the draw.
Candidate counts
Compare
totalEntries with validEntries. Neither value reports the
number of winners.Ordered winners
Keep
position, authorUsername, tweetId, and isBackup for every
selected account.Draw timing
Store
createdAt for creation. Store drawnAt when winner selection has
finished.Interpret Twitter giveaway winner rows
Winner order is part of the result. Keep each 1-indexedposition. Do not
sort by username or tweet ID.Primary winner
isBackup is false. Use the original position in announcements and
fulfillment records.Backup winner
isBackup is true. Keep the row separate until someone approves
the replacement.Winning reply
tweetId identifies the selected reply. Store it beside the winner’s X (Twitter)
username.Winner account
authorUsername identifies the selected X account at draw time. Join
records on the tweet ID, which does not change.Keep eligibility rules separately
GET /draws/{id} returns the draw snapshot and winners. It does not repeat the
eligibility filters sent to POST /draws.
Store the original create request when reviews need these settings.- required repost and followed-account rules
- required keywords, hashtags, mentions, or language
- minimum account age and follower count
- primary, backup, and unique-author settings
Build a giveaway verification handoff
Join the draw summary, winner rows, and export location with one draw ID.position and isBackup
on every row. Never infer filter rules from entry counts.Path parameters
Headers
Response
200 OK
401 Unauthenticated
The API key or OAuth bearer token is missing or invalid. Replace it before retrying.404 Not found
No draw exists with this ID, or it belongs to a different account.429 Rate limited
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 1 }
Too many requests. Wait for the Retry-After header before retrying.Handle giveaway draw responses
200 Draw result
Read
draw and winners. Split primary and backup winners before handoff.401 Authentication
Authentication failed. Replace the API key or OAuth bearer token first.
404 Draw missing
No accessible draw matches that ID. Check its account and exact value.
429 Rate limit
Too many requests. Honor
Retry-After, then retry the same draw ID.Twitter giveaway winner verification questions
How do I verify a past Twitter giveaway winner?
Get the draw ID from giveaway history. RequestGET /draws/{id}. Keep the
ordered winner rows and source tweet snapshot.Does the draw detail include eligibility rules?
No. Store the original create request separately. Use entry exports when a review needs candidate pass or fail values.How do I identify backup winners?
ReadisBackup on every winner row. A primary winner has false. A backup
winner has true.Can I download the giveaway result?
Yes. CallGET /draws/{id}/export. Choose winners or entries and a supported
file format.What if the giveaway draw ID returns 404?
Check the exact draw ID and authenticated account. The current credential cannot read another account’s draw.Does winner verification consume credits?
No. Retrieving an existing draw is free. Running a new draw can consume credits.Related. Export Draw downloads results.
Giveaway History lists past
draws. Create Draw runs a new selection.
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." } - 404
{ "error": "not_found", "message": "Resource not found." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }