# The account's places on the plan waiting lists

`GET /v1/console/waiting-list` (operation id `getWaitingList`)

The account's open waiting-list entries, at most one per plan: `waiting` with its `position` (1 is invited
next), or `invited` with a seat held until `invite_expires_at` (subscribe with `createSubscriptionCheckout`
before then). An entry leaves the list when the account holds its plan, or when its invitation expires.

Authentication: Console session cookie (`__Host-dex_session`), or an app session token (`Authorization: Bearer dex_ses_...`). With the cookie, state-changing routes also need the `x-dex-csrf` header.

## Responses

### 200

The account's entries, oldest first (an empty list when it is on no waiting list).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `object` | string | yes | (always "list") |
| `data` | array of WaitingListEntry | yes |  |
| `data[].object` | string | yes | (always "waiting_list_entry") |
| `data[].plan` | PlanId | yes | A subscription plan (docs/pricing-v2.md). New plans may appear within v1. (one of "base", "hot", "fierce") |
| `data[].status` | string | yes | `waiting`: in the queue. `invited`: a seat is held for the account until `invite_expires_at`; subscribe with `createSubscriptionCheckout` before then. (one of "waiting", "invited") |
| `data[].position` | integer \| null | yes | Place among the accounts waiting for this plan (1 is invited next); null once invited. (at least 1) |
| `data[].created` | string | yes | When the account joined the waiting list. (format date-time) |
| `data[].invite_expires_at` | string \| null | yes | With `invited`, until when the seat is held (72 hours after the invitation); null while waiting. (format date-time) |

### 401

Missing, unknown, revoked or expired credentials.

### 403

The credentials are valid but not allowed to do this (missing scope, suspended account or failed CSRF check).

### 500

An unexpected error. Any charge was refunded. Retry with the same idempotency key.

### 503

`maintenance`: the console's database, sign-in or payments are unavailable for a moment (for
`createGoogleSession` also: Google sign-in is not configured, or Google's signing keys cannot be fetched).
Retry after `retry-after`. Nothing was changed.


## Examples

Illustrative values. Examples show the shape of requests and responses; the numbers in them are not measured results.

Response: On the Hot waiting list, twelfth in line

```json
{
  "object": "list",
  "data": [
    {
      "object": "waiting_list_entry",
      "plan": "hot",
      "status": "waiting",
      "position": 12,
      "created": "2026-09-28T09:41:07Z",
      "invite_expires_at": null
    }
  ]
}
```