---
title: "Get an API token by ID."
method: GET
path: "/apiTokens/{tokenId}"
---

# Get an API token by ID.

`GET /apiTokens/{tokenId}`

## Path parameters

- `tokenId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

Success

- ApiToken — The permission definition.
  - `roles` RoleAssignment[], required — List of role assignments that specify the permissions to access the application.
    - `role` string, required — ID of the role for this role assignment.
    - `organization` string — ID of the organization for this role assignment.

## Other responses

- `default` — An error response received from the IoT Central Service.

---

[API](https://skmtc.net/azure/apis/iotcentral-iotcentral.md) · [All operations](https://skmtc.net/azure/apis/iotcentral-iotcentral/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iotcentral-iotcentral/versions/565d8813cbd3/schema)