---
title: "Get API token by ID"
method: GET
path: "/tokens/{tokenId}"
tags: ["API Tokens"]
---

# Get API token by ID

`GET /tokens/{tokenId}`

Retrieve an API token by their system-generated ID

## Response `200`

Successful operation

- ApiToken
  - `id` string, required — System-generated unique identifier
  - `name` string, required — Name of the token
  - `permissions` Permission[], required — A list of permissions granted to the token
  - `clientId` string, required — An opaque identifier that should be used as a client_id (or username) in the HTTP Basic Authentication scheme when issuing http requests to Grid.
  - `clientSecret` string — The secret that should be used to authenticate against Grid API. This secret is not stored and will never be available again after creation. Platform must keep this secret secure as it grants access to the account.
  - `createdAt` string, date-time, required — Creation timestamp
  - `updatedAt` string, date-time, required — Last update timestamp

## Other responses

- `401` — Unauthorized
- `404` — Token not found
- `500` — Internal service error

## Changes

- **2026-02-13** `2055da1ed488` — 3 breaking, 15 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - the response's body type/format changed from ``/`` to `object`/`` for status `404`
  - the response's body type/format changed from ``/`` to `object`/`` for status `500`
  - removed `#/components/schemas/Error401_UNAUTHORIZED, #/components/schemas/Error401_INVALID_SIGNATURE` from the response body `oneOf` list for the response status `401`
  - …14 more
- **2026-02-05** `42f104b10868` — 12 breaking, 12 warning
  - the `status` response property const value `401` was removed for the status `401`
  - the `status` response property const value `401` was removed for the status `401`
  - the `status` response property const value `404` was removed for the status `404`
  - the `status` response property const value `404` was removed for the status `404`
  - …20 more

[Change history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/tokens/:tokenId/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/revisions/2055da1ed488/schema)