---
title: "List per-key usage for the org."
method: GET
path: "/v1/usage/keys"
tags: ["Metering"]
---

# List per-key usage for the org.

`GET /v1/usage/keys`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/usage/keys`
- Auth: HTTP bearer

Returns each of the organization's API keys with its request count for the
current billing month. Requires the `metering:read` scope.

## Response `200`

Per-API-key request counts for the current month

- KeysUsageResponse: Response for `GET /v1/usage/keys` — the org's API keys and their metadata.
  - `keys` KeyUsage[], required
    - `key_id` string, required: API key id (UUID).
    - `key_name` string, required: Human-friendly key name.
    - `key_prefix` string, required: Non-secret key prefix, e.g. `scalix_sk_ab12`.
    - `last_used_at` string, nullable: RFC3339 timestamp of the key's last use, or null if never used.

## Other responses

- `401`: Missing or invalid API key
- `403`: Token lacks the metering:read scope
- `500`: Internal error

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)