latestOpenAPI 3.1.02026-08-21127127514.8 KB

18302a60cfee

Draws

Get draw details

Get draw details.

get/api/v1/draws/{id}

Path parameters

idstring required
Example:f4bd00a2-7b4e-4e59-8e1b-72e2c9f12345

Draw public ID returned by create and list draw responses.

Response

Draw with winners

Example response

{
  "draw": {
    "id": "f4bd00a2-7b4e-4e59-8e1b-72e2c9f12345",
    "tweetUrl": "https://x.com/elonmusk/status/1234567890",
    "tweetId": "1234567890",
    "tweetText": "Giving away 3 Tesla Model 3s!",
    "tweetAuthorUsername": "elonmusk",
    "status": "completed",
    "totalEntries": 250,
    "validEntries": 200,
    "tweetLikeCount": 50000,
    "tweetRetweetCount": 25000,
    "tweetReplyCount": 10000,
    "tweetQuoteCount": 5000,
    "createdAt": "2025-01-15T12:00:00Z"
  },
  "winners": []
}