---
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}`

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/waitpoints/tokens/{waitpointId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/waitpoints/tokens/:waitpointId/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-02-25** `38d6514341ed`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/waitpoints/tokens/:waitpointId/get.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)