---
title: "List Api Keys"
method: GET
path: "/v1/orgs/{org_id}/api-keys"
tags: ["v1-api-keys"]
---

# List Api Keys

`GET /v1/orgs/{org_id}/api-keys`

## Request

- Base URL: `https://api.tryardent.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tryardent.com/v1/orgs/{org_id}/api-keys`
- Auth: none declared

List all API keys for the organization, active and revoked.

Requires 'api_keys.read' permission.

Returns:
    List of API keys (without secret keys)

## Path parameters

- `org_id` string, required

## Response `200`

Active keys first (newest first), then revoked keys.

- APIKeyListItem[]
  - `id` string, required: API key ID.
  - `name` string, required: Human-readable key name.
  - `key_prefix` string, required: First characters of the key; the secret itself is never returned.
  - `scopes` string[], required: Permission scopes granted to the key.
  - `expires_at` string, nullable: When the key expires. Null when it does not expire.
  - `revoked_at` string, nullable: When the key was revoked. Null for active keys.
  - `revoked_reason` string, nullable: Why the key was revoked: `admin_revoked`, `member_removed`, or `unknown_legacy` for keys revoked before the reason was recorded. Null for active keys.
  - `revoked_by` object, nullable: Who revoked the key: `{email, full_name}`. Null for active keys and for revocations with no attributable user.
  - `created_at` string, required: When the key was created.
  - `last_used_at` string, nullable: When the key last authenticated a request. Null when never used.
  - `users` object, nullable: Who created the key: `{email, full_name}`.

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-14** `885763e37dfb`: 2 info
  - added the optional property `items/revoked_by` to the response with the `200` status
  - added the optional property `items/revoked_reason` to the response with the `200` status

[Operation history](https://skmtc.dev/tryardent/apis/tryardent-api/changes/v1/orgs/:org_id/api-keys/get.md)

---

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