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

# List API keys

`GET /org/api-keys`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/api-keys`
- Auth: API key in header `X-API-Key`

Returns one page of your organization's API keys (never the secret key values, which are shown only once at creation). Creating, updating, revoking, and deleting keys is done in the dashboard — those actions require user authentication and are not available with an API key. The one exception: a key may revoke itself via `POST /org/api-keys/self/revoke`.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

One page of API keys.

- APIKeyListResponse: A paginated list of API keys.
  - `items` APIKeyResponse[], required
    - `id` string, uuid, required
    - `organization_id` string, uuid, required
    - `name` string, required
    - `scoped` boolean, required: Whether the key is restricted to specific knowledge-base folders (see `GET /org/api-keys/{keyId}/kb-permissions`).
    - `expires_at` string, date-time: When the key expires, if an expiry was set.
    - `revoked_at` string, date-time: When the key was revoked. These read endpoints return only active keys, so this is always absent here.
    - `last_used_at` string, date-time: When the key was last used, if ever.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required: Total keys for the organization (before pagination).
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `404`: The requested resource does not exist or is not visible to this key.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)