---
title: "List API keys"
method: GET
path: "/v1/api-keys"
tags: ["API Keys"]
---

# List API keys

`GET /v1/api-keys`

Returns the API keys belonging to the authenticated account.

## Query parameters

- `label` string

## Response `200`

Returns the list of API keys.

- ApiKey[]
  - `id` integer, required — API key ID.
  - `label` string, required — API key label.
  - `value` string, required — API key value.
  - `active` boolean, required — Indicates whether the API key is active.
  - `restricted` boolean, required — Indicates whether IP restrictions are enabled. When enabled, the API key works only from IP addresses in `permitted_ips`.
  - `permitted_ips` string[], required — List of permitted IP addresses. If `restricted` is false, an empty list means no IP restrictions. If `restricted` is true, an empty list prevents all requests.
  - `scopes_enabled` boolean, required — When `true`, the key is restricted to the permissions defined in the scope fields below. When `false`, the key has full access.
  - `last_used_at` string, date-time, nullable, required — Timestamp of the most recent authenticated request made with this key.
  - `numbers` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `trunks` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `calls` ApiKeyCallsScopePermission, required — Permission level for the `calls` scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET requests, `POST /v1/cdrs` - `write`: all methods (includes read)
  - `messages` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `recordings` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `campaigns` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `two_fa` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `validator` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `webhooks` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `embeddable` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `billing` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `account` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `subaccounts` ApiKeyScopePermission, required — Permission level for an API key scope group.
    - `allow` 'none' | 'read' | 'write' — Permission level: - `none`: no access - `read`: GET only - `write`: all methods (includes read)
  - `created_at` string, date-time, required — Creation date and time in ISO 8601 format.

## Other responses

- `401` — Unauthorized
- `403` — Request failed. The feature is disabled for your account.

---

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