List waitlist signups

.md

Page through everyone waiting for you to open.

Scopeswaitlist:read
GET/v1/waitlist/signups

Returns signups newest first, using cursor pagination.

Parameters

ParameterTypeDescription
statusstring, optionalpending, notified, converted or unsubscribed
emailstring, optionalExact match, case insensitive
limitinteger, optional1 to 100, defaults to 20
starting_afterstring, optionalContinue after this id

Request

curl "https://api.proppertrading.com/v1/waitlist/signups?status=pending&limit=50" \
  -H "Authorization: Bearer sk_live_a1b2c3d4_9f83c2e15b7a4d6e8091c3f5a7b9d1e2"

Response

{
    "data": [
        {
            "id": "wl_7hqm4tzvbc82nkxrdp9sfjwe",
            "object": "waitlist_signup",
            "email": "[email protected]",
            "name": "Jamie",
            "status": "pending",
            "reward_code": "LAUNCH-K4M9XR2P",
            "source": "api",
            "metadata": {},
            "created_at": "2026-08-03T17:44:13+00:00",
            "notified_at": null,
            "converted_at": null,
            "unsubscribed_at": null,
            "last_sent_at": "2026-08-03T17:44:13+00:00"
        }
    ],
    "meta": {
        "request_id": "req_01kz4bkr1aj1gv63d8fv3133ey",
        "has_more": false,
        "next_cursor": null
    }
}

Filter on status=unsubscribed before you send anything to the whole list: those people asked to be left alone, and they stay in the list so the address cannot be signed up again for a second code.

Errors

StatusCodeMeaning
400invalid_statusUnknown value for status
400invalid_limitlimit is not a positive integer
400invalid_cursorstarting_after matches nothing