---
title: "List all waitlist entries"
method: GET
path: "/waitlist_entries"
tags: ["Waitlist Entries"]
---

# List all waitlist entries

`GET /waitlist_entries`

Retrieve a list of waitlist entries for the instance.
Entries are ordered by creation date in descending order by default.
Supports filtering by email address or status and pagination with limit and offset parameters.

## Query parameters

- `limit` integer
- `offset` integer
- `query` string
- `status` 'pending' | 'invited' | 'completed' | 'rejected'
- `order_by` string

## Response `200`

List of waitlist entries

- object
  - `data` WaitlistEntry[], required
    - `object` 'waitlist_entry', required
    - `id` string, required
    - `email_address` string, email, required
    - `status` 'pending' | 'invited' | 'rejected' | 'completed', required
    - `is_locked` boolean — Indicates if the waitlist entry is locked. Locked entries are being processed in a batch action and are unavailable for other actions.
    - `created_at` integer, required — Unix timestamp of creation.
    - `updated_at` integer, required — Unix timestamp of last update.
    - `invitation` Invitation
      - `object` 'invitation', required
      - `id` string, required
      - `email_address` string, email, required
      - `public_metadata` object, required
      - `revoked` boolean
      - `status` 'pending' | 'accepted' | 'revoked' | 'expired', required
      - `url` string
      - `expires_at` integer, nullable — Unix timestamp of expiration.
      - `created_at` integer, required — Unix timestamp of creation.
      - `updated_at` integer, required — Unix timestamp of last update.
  - `total_count` integer, required — Total number of waitlist entries

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/75df3a43fcb2/schema)