---
title: "List The Team'S Api Keys With Their Recent Usage"
method: GET
path: "/v0/api-keys/usage"
tags: ["API Keys"]
---

# List The Team'S Api Keys With Their Recent Usage

`GET /v0/api-keys/usage`

Every active key of the current team, with the calls it made over the usage window and whether the member who created it still belongs to the workspace. Key (token) strings are never returned.

## Query parameters

- `window_days` integer

## Response `200`

Successful Response

- ApiKeyWithUsage[]
  - `id` string, uuid, required
  - `name` string, nullable, required
  - `created_by` integer, required
  - `created_by_email` string, required
  - `created_at` string, date-time, required
  - `last_used_at` string, date-time, nullable — Last request made with this key, ever. Read from the key row, not from the request events, so it stays true for a key last used before event collection began.
  - `calls_in_window` integer, required — Requests made with this key inside the usage window.
  - `daily_calls` DailyCallCount[], required — One point per day of the window, oldest first, quiet days included as zeros so the series can be charted as-is.
    - `day` string, date, required
    - `calls` integer, required
  - `created_by_is_active_member` boolean, required — False once the creator has been removed from the workspace. Such a key keeps working, and whoever left may still know its value, so the UI asks the team to replace it.

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.dev/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/revisions/8bedcc2de5ec/schema)