---
title: "Retrieve a list of API keys"
method: GET
path: "/keys"
tags: ["keys"]
---

# Retrieve a list of API keys

`GET /keys`

Returns a list of all API keys the user has access to

## Query parameters

- `$limit` integer
- `$skip` integer
- `$sort` object
- `filter` Keys — An API key allows machine-to-machine authentication and authorization
  - `id` string — Unique ID of the API key
  - `name` string — Name of the API key to help identify it. This could be the name of the app or team that will be using it, or a short description of what the key will be used for
  - `description` string — Description of the API key
  - `organization_id` string — ID of the organization that owns the API key
  - `created_at` string — Creation date of the API key (ISO8601)
  - `enabled` boolean — Status of the API key. A disabled API key cannot be used for obtaining a token. Already issued tokens remain valid until their expiration.
  - `is_internal` boolean — Marks an API key as internal. These keys are managed by Didomi. Internal keys are excluded from list results unless explicitly requested.

## Response `200`

A list of APIKey objects

- Keys[]
  - `id` string — Unique ID of the API key
  - `name` string — Name of the API key to help identify it. This could be the name of the app or team that will be using it, or a short description of what the key will be used for
  - `description` string — Description of the API key
  - `organization_id` string — ID of the organization that owns the API key
  - `created_at` string — Creation date of the API key (ISO8601)
  - `enabled` boolean — Status of the API key. A disabled API key cannot be used for obtaining a token. Already issued tokens remain valid until their expiration.
  - `is_internal` boolean — Marks an API key as internal. These keys are managed by Didomi. Internal keys are excluded from list results unless explicitly requested.

---

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