---
title: "Retrieve an API token"
method: GET
path: "/v1/api-keys/{id}"
tags: ["API Tokens"]
---

# Retrieve an API token

`GET /v1/api-keys/{id}`

<Note>
  This endpoint requires **Organization Admin** permissions.
</Note>

  description: Token id. Must be a valid UUID — malformed values return `400`.

## Response `200`

Token found successfully.

- object
  - `id` string, uuid, required — The token's unique identifier.
  - `name` string, required — The name given when the token was created. Not unique within an organization.
  - `type` 'organization' | 'personal' | 'mcp', required — Token type: - `organization` - Organization API key - `personal` - Personal Access Token (PAT) - `mcp` - MCP OAuth PAT
  - `enabled` boolean, required — Whether the token can currently authenticate. Organization Admins can disable any token type; disabled tokens remain visible but cannot authenticate.
  - `createdAt` string, date-time, required — ISO 8601 timestamp of when the token was created (UTC).
  - `membershipId` string, uuid, nullable, required — The user membership the token is scoped to. `null` if `type` is `organization`.

## Other responses

- `400` — Bad Request. The ID parameter is not a valid UUID, or the Authorization header is malformed. Possible error messages: - `Bad Request: id: Invalid UUID` - `Bad authorization header, must be formatted as Bearer <token>`
- `401` — Unauthorized. The Authorization header is missing or malformed.
- `403` — Forbidden. Authentication succeeded but the caller is not an organization admin, or the bearer token is invalid.
- `404` — Not Found. No token with that ID exists in the caller's organization. The same `404` response is returned regardless of whether the token exists in a different organization - no tenant information is leaked. Example error message: - `Api key with id 00000000-0000-0000-0000-000000000000 does not exist`
- `405` — Method Not Allowed - Invalid HTTP method for this endpoint
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)