# List keys

> Returns all of your active (non-revoked) keys, newest first. The raw secret is never returned, only the id, name, prefix, rate limit, and usage metadata.

Source: https://warmerly.com/docs/keys/list-keys

```text
GET /keys
```

Returns all of your active (non-revoked) keys, newest first. The raw secret is never returned, only the id, name, prefix, rate limit, and usage metadata.

```bash
curl https://app.warmerly.com/api/v1/keys \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

```json
{
  "keys": [
    {
      "id": "3b1f6e2a-9c4d-4e2a-8b5f-6a2c1d9e0f7b",
      "name": "CI pipeline",
      "prefix": "wmv_7f3a2c",
      "rateLimitPerMin": 60,
      "lastUsedAt": "2026-07-01T09:12:44.000Z",
      "createdAt": "2026-06-20T14:03:11.000Z"
    },
    {
      "id": "9a2d4c11-5e7b-4f10-b2aa-1c8f0d3e6a4b",
      "name": "Zapier",
      "prefix": "wmv_9d1e0b",
      "rateLimitPerMin": 120,
      "lastUsedAt": null,
      "createdAt": "2026-06-18T08:47:02.000Z"
    }
  ]
}
```

| Field | Type | Description |
| --- | --- | --- |
| `id` | string (UUID) | Key ID, use this to revoke the key. |
| `name` | string | The label you gave the key when creating it. |
| `prefix` | string | The first few characters of the key (`wmv_...`), useful for identifying which key is which without exposing the secret. |
| `rateLimitPerMin` | number | Requests per minute allowed for this key. |
| `lastUsedAt` | string \\| null | ISO 8601 timestamp of the key's most recent authenticated request, or `null` if it has never been used. |
| `createdAt` | string | ISO 8601 timestamp of when the key was created. |

Revoked keys are excluded from this list entirely.

## More from API Keys

- [Create a key](https://warmerly.com/docs/keys/create-a-key): Each user can hold at most 10 active keys; creating an 11th (without revoking one first) returns 400 with…
- [Revoke a key](https://warmerly.com/docs/keys/revoke-a-key): Revokes (soft-deletes) the key. Revoked keys fail authentication immediately on their next request, there is…