> ## Documentation Index
> Fetch the complete documentation index at: https://docs-restapi.wplimit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Waiting List Entries

> Retrieve the waiting list of sold-out events, in queue order.

> [!NOTE]
>
> **LatePoint Pro feature.** The waiting list requires LatePoint Pro Features with Waiting List enabled in LatePoint settings. Otherwise this endpoint returns `503` (`feature_not_available` or `feature_disabled`). See [Pro features](https://docs-restapi.wplimit.com/api-reference/events/overview.md#pro-features).

Customers join the waiting list from LatePoint's booking form when an event is sold out; entries cannot be created through the API. When a place becomes free you can [invite](https://docs-restapi.wplimit.com/api-reference/events/waiting-list-invite.md) the customer, [promote](https://docs-restapi.wplimit.com/api-reference/events/waiting-list-promote.md) them directly (free events), or [remove](https://docs-restapi.wplimit.com/api-reference/events/waiting-list-remove.md) the entry.

## Query Parameters

**page** `integer` (default: 1)

Page number for pagination

**per\_page** `integer` (default: 10)

Number of entries per page

**event\_id** `integer`

Filter by event ID

**customer\_id** `integer`

Filter by customer ID

**ticket\_type\_id** `integer`

Filter by ticket type ID

**status** `string`

Filter by status. Available values: `waiting`, `invited`, `converted`, `removed`, `expired`

**include\_history** `boolean` (default: false)

By default only live entries (`waiting` and `invited`) are returned. Set to `true` to also include `converted`, `removed` and `expired` entries. Ignored when `status` is sent.

Entries are ordered by the time they joined the queue (oldest first).

## Example Request

```bash theme={null}
GET /wp-json/latepoint-api/v1/events/waiting-list?event_id=3
Authorization: Bearer YOUR_API_KEY
```

## Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": 1,
      "event_id": 3,
      "customer_id": 40,
      "customer": {
        "id": 40,
        "first_name": "Api",
        "last_name": "Tester",
        "full_name": "Api Tester",
        "email": "api.tester@example.com",
        "phone": ""
      },
      "ticket_type_id": null,
      "ticket_type_name": null,
      "quantity": 1,
      "status": "waiting",
      "status_label": "Waiting",
      "position": 1,
      "invited_at": null,
      "invite_expires_at": null,
      "converted_registration_id": null,
      "converted_order_id": null,
      "created_at": "2026-10-28 16:10:05",
      "updated_at": "2026-10-28 16:10:05"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total": 1,
    "total_pages": 1,
    "has_next_page": false,
    "has_previous_page": false
  }
}
```

## Response Fields

**id** `integer`

Unique identifier for the entry

**event\_id** `integer`

Event ID

**customer\_id** `integer`

Customer ID

**customer** `object`

Customer summary (`id`, `first_name`, `last_name`, `full_name`, `email`, `phone`)

**ticket\_type\_id** `integer`

Requested ticket type, when the event uses ticket types

**ticket\_type\_name** `string`

Requested ticket type name

**quantity** `integer`

Number of places requested

**status** `string`

`waiting`, `invited`, `converted`, `removed` or `expired`

**status\_label** `string`

Human-readable status

**position** `integer`

Position in the queue. `null` when the entry is no longer live.

**invited\_at** `string`

When the customer was invited (UTC)

**invite\_expires\_at** `string`

When the invitation expires (UTC)

**converted\_registration\_id** `integer`

Registration created from this entry

**converted\_order\_id** `integer`

Order created from this entry

**created\_at** `string`

When the customer joined the queue

**updated\_at** `string`

Last update timestamp


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.