---
title: "List API keys"
method: GET
path: "/user-service/api-keys"
tags: ["ApiKeys"]
---

# List API keys

`GET /user-service/api-keys`

Retrieve a list of API keys for the specified account

## Query parameters

- `search` string
- `type` 'TEAM' | 'USER' | 'SA'
- `email` string, email
- `user_id` string, uuid
- `team_id` string, uuid
- `limit` integer
- `offset` integer

## Response `200`

Array of API keys

- ApiKeyListResponse
  - `api_keys` ApiKey[]
    - `id` string, uuid, required — Unique identifier for the API key
    - `key` string, required — The key identifier (defaults to id for legacy keys, can be updated to any string value)
    - `is_legacy` boolean, required — Whether this is a legacy API key
    - `account_id` string, required — Account identifier this API key belongs to
    - `type` 'TEAM' | 'USER', required — Type of API key (scope)
    - `user_id` string, uuid, nullable — User ID if this is a user-scoped API key
    - `user_name` string, nullable — Name of the user if this is a user-scoped API key
    - `team_id` string, uuid, nullable — Team ID if this is a team-scoped API key
    - `team_name` string, nullable — Name of the team if this is a team-scoped API key
    - `alias` string, nullable — Human-readable alias for the API key
    - `description` string, nullable — Description of the API key's purpose
    - `expires_at` string, date-time, nullable — When the API key expires
    - `last_used` string, date-time, nullable — When the API key was last used for authentication
    - `created_by` string, uuid, nullable — User ID of the person who created this API key
    - `created_by_name` string, nullable — Name of the user who created this API key
    - `created_at` string, date-time, required — When the API key was created
    - `updated_at` string, date-time — When the API key was last updated
  - `total_count` integer — Total number of API keys matching the filter criteria

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/firefly/apis/firefly-user-management-service-api.md) · [All operations](https://skmtc.net/firefly/apis/firefly-user-management-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/firefly-user-management-service-api/revisions/3d5d69795558/schema)