---
title: "Retrieve a waitpoint token"
method: GET
path: "/api/v1/waitpoints/tokens/{waitpointId}"
tags: ["waitpoints"]
---

# Retrieve a waitpoint token

`GET /api/v1/waitpoints/tokens/{waitpointId}`

Retrieves a waitpoint token by its ID, including its current status and output if it has been completed.

## Path parameters

- `waitpointId` string, required

## Response `200`

Successful request

- WaitpointTokenObject
  - `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.

## Other responses

- `401` — Unauthorized
- `404` — Waitpoint token not found
- `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)