---
title: "List waitpoint tokens"
method: GET
path: "/api/v1/waitpoints/tokens"
tags: ["waitpoints"]
---

# List waitpoint tokens

`GET /api/v1/waitpoints/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.

## Query parameters

- `page[size]` integer
- `page[after]` string
- `page[before]` string
- `filter[status]` string
- `filter[idempotencyKey]` string
- `filter[tags]` string
- `filter[createdAt][period]` string
- `filter[createdAt][from]` string, date-time
- `filter[createdAt][to]` string, date-time

## Response `200`

Successful request

- ListWaitpointTokensResult
  - `data` WaitpointTokenObject[], required — An array of waitpoint token objects.
    - `id` string, required — The unique ID of the waitpoint token.
    - `url` string, required — An HTTP callback URL. A POST request to this URL (with an optional JSON body) will complete the waitpoint without needing an API key.
    - `status` 'WAITING' | 'COMPLETED' | 'TIMED_OUT', required — The current status of the waitpoint token.
    - `idempotencyKey` string, nullable — The idempotency key used when creating the token, if any.
    - `idempotencyKeyExpiresAt` string, date-time, nullable — When the idempotency key expires.
    - `timeoutAt` string, date-time, nullable — When the token will time out, if a timeout was set.
    - `completedAt` string, date-time, nullable — When the token was completed, if it has been completed.
    - `output` string, nullable — The serialized output data passed when completing the token. Only present when `status` is `COMPLETED`.
    - `outputType` string, nullable — The content type of the output (e.g. `"application/json"`).
    - `outputIsError` boolean, nullable — Whether the output represents an error (e.g. a timeout).
    - `tags` string[], required — Tags attached to the waitpoint.
    - `createdAt` string, date-time, required — When the waitpoint token was created.
  - `pagination` object, required
    - `next` string, nullable — Cursor for the next page. Pass as `page[after]` in the next request.
    - `previous` string, nullable — Cursor for the previous page. Pass as `page[before]` in the next request.

## Other responses

- `401` — Unauthorized
- `422` — Invalid query parameters (e.g. unrecognised status value)
- `500` — Internal Server Error

---

[API](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api.md) · [All operations](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/winsenlabs/trigger-dev-v3-rest-api/versions/737c498e605b/schema)