Sign in
Waitlist Entries

List Waitlist Entries

Lists visible waitlist signups. waitlist_entry:read grants the user's own signups; plan:waitlist:read grants signups for authorized seller accounts. With both permissions, returns their union. Account credentials are limited to their account. Filters narrow this set.

get/waitlist_entries

Query parameters

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

plan_idstring

Only return signups for this plan, prefixed plan_.

account_idstring

Only return signups submitted to this seller account, prefixed biz_.

product_idstring

Only return signups for plans on this product, prefixed prod_.

status'pending' | 'approved' | 'denied' | 'canceled'

Only return signups in this state. Canceled signups are returned only when status is canceled.

created_beforestring date_time

Only return signups submitted at or before this ISO 8601 timestamp.

created_afterstring date_time

Only return signups submitted at or after this ISO 8601 timestamp.

order'created_at'

The field to sort results by. Defaults to created_at.

direction'asc' | 'desc'

The sort direction for results. Defaults to descending.

Response

own signups only

Example response

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "approval_failure_reason": "plan_unavailable",
      "created_at": "2026-01-01T12:00:00.000Z",
      "id": "entry_xxxxxxxxxxxxxx",
      "metadata": {},
      "plan_id": "plan_xxxxxxxxxxxxxx",
      "product_id": "prod_xxxxxxxxxxxxxx",
      "status": "canceled",
      "updated_at": "2026-01-01T12:00:00.000Z",
      "user_id": "user_xxxxxxxxxxxxxx"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes