:::endpoint GET /v1/affiliates/pre-registrations

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

## Parameters

| Parameter        | Type              | Description                                  |
| ---------------- | ----------------- | -------------------------------------------- |
| `status`         | string, optional  | `pending`, `claimed`, `revoked` or `expired` |
| `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/affiliates/pre-registrations?status=pending&limit=50" \
  -H "Authorization: Bearer sk_live_a1b2c3d4_9f83c2e15b7a4d6e8091c3f5a7b9d1e2"
```

## Response

```json
{
    "data": [
        {
            "id": "aff_pre_zd95p9x9prp3cga9thjusesr",
            "object": "affiliate_pre_registration",
            "email": "jamie@example.com",
            "referral_code": "0WWI7YCQ",
            "referral_url": "https://acmefunded.com/r/0WWI7YCQ",
            "status": "pending",
            "source": "api",
            "metadata": {},
            "created_at": "2026-08-03T17:44:13+00:00",
            "expires_at": null,
            "claimed_at": null,
            "last_sent_at": "2026-08-03T17:44:13+00:00"
        }
    ],
    "meta": {
        "request_id": "req_01kz4bkr1aj1gv63d8fv3133ey",
        "has_more": false,
        "next_cursor": null
    }
}
```

## 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  |