Public endpoints

Everything a draw rests on is public, with no key and with CORS open, at https://www.prizerail.com.

A campaign’s draws

GET /campaigns/{slug}/draws.json

The campaign (name, status, cadence, time zone, winners per draw, payout chain and token) and its draws, newest first. Each draw has its id, number, drawAt, cutoffAt, stage, number of winners, winnersCommitment, lockedAt, settledAt, paidAt and a link to its proof.

Query	Meaning
limit	Up to 100. Default 30.
before	A date. Pass the response’s nextBefore to page back.

A draw’s proof

GET /campaigns/{slug}/draws/{id}/proof.json

Available once a draw is drawn:

Field	Holds
campaign	id (the contract’s campaign ID), slug and name.
drawing	id, number (the contract’s drawing ID) and drawAt.
winnerList	winners in order, their commitment and lockedAt.
entropy	provider, requestId, value and revealedAt.
prizeTable	version, denominator and tiers, top prize first, each with amountCents, weight and threshold.
results	Each winner’s position, winner, displayName, randomValue, roll and amountCents.

displayName is the partner’s public name for the winner, shown only and never hashed.

The verify script

GET /verify/verify-draw.mjs

See Verify a draw.

Stages

The public pages call a drawing a draw and describe its stage in plain words. The partner API uses the same ids with its own status names:

Public stage	API status	Meaning
open	open	Taking winners until cutoffAt.
locked	locked	The winner list is locked and its fingerprint recorded.
drawing	entropy_requested	The random value has been requested.
drawn	settled	Prizes are decided and the proof is published.
paid	paid	Prizes are sent to the partner to pay out.

A draw’s id here is the same as the drawing’s id in the API, so /campaigns/{slug}/draws/{id}/proof.json and /api/v1/campaigns/{slug}/drawings/{id} describe the same draw.

An unknown campaign returns 404, and so does the proof of a draw that isn’t drawn yet. Amounts are US cents, and times are ISO 8601 in UTC.