Campaigns - Prizerail

Everything your app needs to show what people can win and link the rules: the prize table, when draws happen and when entries close, the guarantee, and the terms and privacy links.

Get a campaign

GET /api/v1/campaigns/{slug}

{
  "campaign": {
    "slug": "acme-daily",
    "name": "Daily draw",
    "status": "active",
    "page": "https://prizerail.com/campaigns/acme-daily",
    "schedule": {
      "cadence": "daily",
      "drawHour": 16,
      "drawMinute": 0,
      "drawWeekday": null,
      "drawDayOfMonth": null,
      "timezone": "UTC",
      "cutoffMinutes": 60,
      "startsAt": "2026-10-14T16:00:00.000Z",
      "endsAt": null
    },
    "winnersPerDraw": 3,
    "prizeTable": {
      "id": "t4q8…",
      "version": 2,
      "denominator": 100000,
      "tiers": [
        { "amountCents": 10000000, "weight": 1, "odds": 0.00001 },
        { "amountCents": 100000, "weight": 10, "odds": 0.0001 },
        { "amountCents": 10000, "weight": 400, "odds": 0.004 },
        { "amountCents": 2000, "weight": 4000, "odds": 0.04 },
        { "amountCents": 1000, "weight": 50000, "odds": 0.5 },
        { "amountCents": 500, "weight": 45589, "odds": 0.45589 }
      ],
      "averagePrizeCents": 958
    },
    "guarantee": { "amountCents": 10000, "thresholdCents": 10000, "periodDays": 30 },
    "largePrizeThresholdCents": 50000,
    "termsUrl": "https://acme.example/sweepstakes-rules",
    "privacyUrl": "https://prizerail.com/privacy",
    "nextDrawing": {
      "id": "d7k2m9q4x1wz",
      "drawAt": "2026-10-17T16:00:00.000Z",
      "cutoffAt": "2026-10-17T15:00:00.000Z",
      "winnersPerDraw": 3,
      "averagePrizeCents": 958
    }
  }
}

Fields

Field	Meaning
`status`	`draft`, `active`, `paused` or `ended`. See Status and lifecycle.
`page`	The campaign’s public page, with its odds, every draw and how to check them.
`schedule`	When draws happen, in `timezone`. `drawHour` and `drawMinute` set the time (hourly campaigns use the minute only), `drawWeekday` (0 Sunday to 6 Saturday) the day for weekly ones, and `drawDayOfMonth` (1 to 31, the last day in shorter months) for monthly ones. Entries close `cutoffMinutes` before each draw.
`winnersPerDraw`	How many winners each draw has. If fewer people entered, everyone wins.
`prizeTable`	The table open drawings draw with. `tiers` run top prize first. Each winner’s roll lands on a tier on `weight` of the table’s `denominator` rolls, so `odds` is that chance, from 0 to 1. The top prize is won at most once per draw, so with several winners its real chance is a little lower and the second prize’s a little higher. `averagePrizeCents` is the average prize per winner with that rule applied. See Prize tables.
`guarantee`	The prize guaranteed each period when no draw pays the threshold, or `null`. See Guarantees.
`largePrizeThresholdCents`	Prizes at or above this are paid by hand after checks, not in the automatic transfer.
`termsUrl`, `privacyUrl`	The campaign’s own terms and privacy links, or Prizerail’s when it has none. Link them wherever people enter.
`nextDrawing`	The next drawing still taking entries, or `null` when none is open, for example while the campaign is paused. A drawing’s number of winners is fixed when it’s made, about 48 hours ahead, so after you change `winnersPerDraw` its own `winnersPerDraw` and `averagePrizeCents` can differ from the campaign’s for a day or two. Show these for the draw people are entering now.

Amounts are US cents.

When you publish a new prize table version, every open drawing moves to it. A drawing’s table is fixed once its list locks at the cutoff, so a locked or past draw keeps the table it drew with. Each drawing in Drawings carries its own prizeTable, so to show the odds a past draw used, read them there.