Fetch Scheduled Drawings

Retrieve all scheduled winner drawings for a specific sweepstakes. This endpoint returns a list of all scheduled drawings including their configuration, status, and timing details.

POST https://api-v3.sweeppea.com/winners/fetchscheduled

Description

This endpoint allows you to fetch all scheduled drawings for a specific sweepstakes. It returns detailed information about each scheduled drawing including timing, frequency, number of winners, and current status.

Important Notes:

The sweepstakes must belong to the authenticated user
Results are sorted by creation date (newest first)
Includes all scheduled drawings regardless of status

Request Body

Parameter	Type	Required	Description
`SweepstakesToken`	String (UUID v4)	Yes	The unique identifier of the sweepstakes

Code Examples

curl -X POST "https://api-v3.sweeppea.com/winners/fetchscheduled" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"SweepstakesToken": "uuid-v4-string"}'

const response = await fetch('https://api-v3.sweeppea.com/winners/fetchscheduled', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    SweepstakesToken: 'uuid-v4-string'
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://api-v3.sweeppea.com/winners/fetchscheduled"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "SweepstakesToken": "uuid-v4-string"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Response

{
  "Response": true,
  "Drawings": [
    {
      "ScheduleToken": "uuid-v4-string",
      "CreationDate": "2026-02-16T13:27:19.206Z",
      "Action": 1,
      "ScheduleMode": 2,
      "Frequency": 0,
      "HowManyWinnersToPick": 1,
      "DayOfTheWeek": 0,
      "WeekOfTheMonth": 0,
      "DrawingDate": "2025-02-20T00:00:00.000Z",
      "DrawingTime": "15:00",
      "DeliveryTime": "",
      "DrawingEndDate": null,
      "DrawingEndTime": "",
      "Timezone": "1",
      "TimezoneDescription": "Eastern Time (US & Canada)",
      "GroupToken": "allgroups",
      "GroupName": "All Groups",
      "Message": null,
      "Options": {
        "IncludeOptedOutParticipants": false,
        "PublishToWinnersPage": false,
        "SendCopyToMe": false,
        "DoNotIncludeSpamParticipants": true
      },
      "Status": 0,
      "StatusDescription": "Pending"
    }
  ],
  "Total": 1
}

Error Responses

{
  "Response": false,
  "Message": "Missing or invalid Bearer token. Send your API token in the Authorization header as: Authorization: Bearer YOUR_API_TOKEN",
  "Code": 401
}

{
  "Response": false,
  "Message": "Invalid API token",
  "Code": 403
}

{
  "Response": false,
  "Message": "Missing SweepstakesToken in request body",
  "Help": {
    "ExpectedBody": {
      "SweepstakesToken": "string (required) \u2014 UUID v4 of the sweepstakes"
    }
  },
  "Code": 400
}

{
  "Response": false,
  "Message": "Sweepstakes not found",
  "Code": 404
}

{
  "Response": false,
  "Message": "You do not have permission to access this sweepstakes",
  "Code": 403
}