Skip to main content
GET
/
draws
/
{id}
Get draw
curl --request GET \
  --url https://xquik.com/api/v1/draws/{id} \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

Free - does not consume credits
curl https://xquik.com/api/v1/draws/f4bd00a2-7b4e-4e59-8e1b-72e2c9f12345 \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
Path parameters

​
id
string
required
The draw public ID. Returned when you create a draw or list draws.

​
Headers

​
x-api-key
string
required
Your API key. This endpoint also accepts session cookie authentication.

​
Response

​
draw
object
Draw details including tweet metadata.
​
winners
array
Selected winners and backup winners ordered by position.
{
  "draw": {
    "id": "f4bd00a2-7b4e-4e59-8e1b-72e2c9f12345",
    "tweetId": "1893456789012345678",
    "tweetUrl": "https://x.com/xquik/status/1893456789012345678",
    "tweetText": "Giveaway time! Reply to enter. 3 winners get a free month of Xquik Pro.",
    "tweetAuthorUsername": "xquik",
    "tweetLikeCount": 2450,
    "tweetRetweetCount": 1820,
    "tweetReplyCount": 847,
    "tweetQuoteCount": 95,
    "status": "completed",
    "totalEntries": 847,
    "validEntries": 312,
    "createdAt": "2026-02-24T10:00:00.000Z",
    "drawnAt": "2026-02-24T10:05:00.000Z"
  },
  "winners": [
    {
      "position": 1,
      "authorUsername": "alice_web3",
      "tweetId": "1893456789012345700",
      "isBackup": false
    },
    {
      "position": 2,
      "authorUsername": "bob_dev",
      "tweetId": "1893456789012345701",
      "isBackup": false
    },
    {
      "position": 3,
      "authorUsername": "charlie_nft",
      "tweetId": "1893456789012345702",
      "isBackup": false
    }
  ]
}
Related: Export Draw to download results as CSV/XLSX/Markdown · List Draws to see all draws · Create Draw to run a new draw.
Last modified on May 6, 2026