:::endpoint GET /v1/waitlist/signups

Returns signups newest first, using [cursor pagination](/docs/api/pagination).

## Parameters

| Parameter        | Type              | Description                                          |
| ---------------- | ----------------- | ---------------------------------------------------- |
| `status`         | string, optional  | `pending`, `notified`, `converted` or `unsubscribed` |
| `email`          | string, optional  | Exact match, case insensitive                        |
| `limit`          | integer, optional | 1 to 100, defaults to 20                             |
| `starting_after` | string, optional  | Continue after this id                               |

## Request

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

## Response

```json
{
    "data": [
        {
            "id": "wl_7hqm4tzvbc82nkxrdp9sfjwe",
            "object": "waitlist_signup",
            "email": "jamie@example.com",
            "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

| Status | Code             | Meaning                           |
| ------ | ---------------- | --------------------------------- |
| 400    | `invalid_status` | Unknown value for `status`        |
| 400    | `invalid_limit`  | `limit` is not a positive integer |
| 400    | `invalid_cursor` | `starting_after` matches nothing  |