---
title: "List workspace API keys"
method: GET
path: "/v1/api-keys"
---

# List workspace API keys

`GET /v1/api-keys`

## Request

- Base URL: `https://api.uploadcheck.app`
- URL: `https://api.uploadcheck.app/v1/api-keys`
- Auth: HTTP bearer

Operator/admin bearer keys can review redacted API keys globally or by workspace_id. Stored workspace API keys with api_keys:read are pinned to their own workspace even if a different workspace_id query parameter is supplied.

## Query parameters

- `workspace_id` string

## Response `200`

Redacted API key records

- object
  - `keys` ApiKeyRecord[]
    - `keyId` string
    - `name` string
    - `workspaceId` string
    - `ownerEmail` string, nullable
    - `provisioningId` string, nullable
    - `checkoutCustomerId` string, nullable
    - `checkoutSubscriptionId` string, nullable
    - `tokenPrefix` string
    - `scopes` string[]
    - `planId` string, nullable
    - `includedMinutes` integer, nullable
    - `planPriceCents` integer, nullable
    - `overageCapCents` integer, nullable
    - `active` boolean
    - `createdAt` string, date-time
    - `lastUsedAt` string, date-time, nullable

## Other responses

- `401`: Missing or invalid API key
- `403`: API key lacks api_keys:read scope

---

[API](https://skmtc.dev/uploadcheck/apis/uploadcheck-app-api.md) · [All operations](https://skmtc.dev/uploadcheck/apis/uploadcheck-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uploadcheck/apis/uploadcheck-app-api/revisions/d7c8a14caa30?raw)