---
title: "get all tokens"
method: GET
path: "/api/v1/tokens"
tags: ["tokens"]
---

# get all tokens

`GET /api/v1/tokens`

This can only be done by a logged in user who has the required privileges.

## Query parameters

- `meta` boolean

## Response `200`

List all tokens

- Token[]
  - `inquirer` string, required — Id of user or a service running on behalf of the user. Who wants the token to be created.
  - `initiator` string — user or a a service who initiated this token request. Who is requesting the token creation (must have the permission to create a token). Defaults to requester id.
  - `accountId` string, required — Affected account the token is created for
  - `token` string
  - `type` 'EPHEMERAL_SERVICE_ACCOUNT' | 'PERSISTENT' | 'SELF'
  - `permissions` Permissions[]
  - `tokenLifeSpan` string — indicates the lifespan of the token. Possible values are -1 for permanent token and a string expression describing a time span, e.g. 2m, 5h

## Changes

- **2021-08-25** `46700dd5e784` — 2 info
  - the response property `items/accountId` became required for the status `200`
  - the response property `items/inquirer` became required for the status `200`
- **2021-03-17** `c9349f4e8a10` — 1 info
  - added the new optional `query` request parameter `meta`
- **2019-08-15** `42619b8ccbbe` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/changes/api/v1/tokens/get.md)

---

[API](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih.md) · [All operations](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintegrationhub/iam-api-for-oih/revisions/016871a170fd/schema)