v1

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-05-044743166.6 KB
waitpoints

List waitpoint tokens

Returns a paginated list of waitpoint tokens for the current environment. Results are ordered by creation date, newest first. Use cursor-based pagination with page[after] and page[before] to navigate pages.

get/api/v1/waitpoints/tokens

Query parameters

page[size]integer

Number of tokens to return per page (1–100).

page[after]string

Return tokens after this cursor (from pagination.next in a previous response).

page[before]string

Return tokens before this cursor (from pagination.previous in a previous response).

filter[status]string

Comma-separated list of statuses to filter by. Allowed values: WAITING, COMPLETED, TIMED_OUT.

filter[idempotencyKey]string

Filter by idempotency key.

filter[tags]string

Comma-separated list of tags to filter by.

filter[createdAt][period]string

Shorthand time period to filter by creation date (e.g. 1h, 24h, 7d). Cannot be combined with filter[createdAt][from] or filter[createdAt][to].

filter[createdAt][from]string date-time

Filter tokens created at or after this ISO 8601 timestamp.

filter[createdAt][to]string date-time

Filter tokens created at or before this ISO 8601 timestamp.

Response

Successful request

Example response

{
  "data": [
    {
      "id": "waitpoint_abc123",
      "url": "https://api.trigger.dev/api/v1/waitpoints/tokens/waitpoint_abc123/callback/abc123hash"
    }
  ],
  "pagination": {
    "next": "waitpoint_abc123",
    "previous": "waitpoint_xyz789"
  }
}