Entries

Read waitlist signups, positions, and referral stats.

Entries are the people who signed up on your waitlist page. The API exposes them read-only; signups themselves happen on the hosted page.

List entries

curl "https://usewait.com/api/v1/waitlists/acme-robotics/entries?limit=50&offset=0" \
  -H "Authorization: Bearer uw_live_YOUR_KEY"

{
  "total": 1290,
  "limit": 50,
  "offset": 0,
  "entries": [
    {
      "id": "a3b1...",
      "email": "ada@example.com",
      "name": "Ada",
      "position": 1287,
      "referralCode": "r4nd0m",
      "referralCount": 3,
      "referredBy": null,
      "createdAt": "2026-07-21T18:03:11.000Z"
    }
  ]
}

Query parameters

Entries are ordered newest first. total is the full count for the waitlist, so offset + limit < total means there are more pages.