Opening
Home / Docs / API Reference / Forms The Forms API exposes your SMASHSEND waitlist and referral forms: where a participant sits in the queue, how many people they have referred, and which rewards they have unlocked. Use i
S
docs- Words
- 511
- Reading time
- 2 min
- Last crawled
- 2026-09-27
- Language
- EN
Authentication
Server-side endpoints authenticate with your API key as a Bearer token. The workspace is derived from the key, so there is no workspace ID in the URL. The public endpoints further down use a form's public key instead. Th
Get a participant's position
GET/v1/forms/{formId}/entries/{entryIdOrEmail}/position Looks up a single entry by its ID or by email address. This is the endpoint to call when someone returns to your site and you want to show "you are #128 of 4,000".
List an entry's rewards
GET/v1/forms/{formId}/entries/{entryId}/rewards Returns the reward ledger for one entry: every reward tier the participant has reached and its current review state. Use it to render "2 of 3 rewards unlocked" next to thei
Public (browser-safe) endpoints
These use the form's public key and need no API key, so you can call them straight from your own signup page or a custom referral dashboard. POST/v1/forms/{publicKey}/submit Submits an entry. Pass with the referrer's pub
Errors
Errors return a JSON body with a machine-readable code. A means the form or entry does not exist in the workspace tied to your API key.
6 in stockinsert query
