Skip to main content
curl https://xquik.com/api/v1/draws/66666 \
  -H "x-api-key: xq_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2" | jq

Path Parameters

id
string
required
The unique draw 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": "66666",
    "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.