# GET /api/v1/keys

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/keys-list

## Summary

List API keys on this account. Each row includes id, name, prefix, inbox_id, permissions, created_at, last_used_at, expires_at, and revoked_at. The secret is never included. Requires key_read. An inbox-scoped key lists only keys for that inbox.

## Request

This call has no JSON body.

## Response

HTTP 200. Sample values illustrate the schema.

```json
{
  "object": "list",
  "data": [
    {
      "id": "inb_example",
      "name": "string",
      "prefix": "string",
      "inbox_id": "inb_example",
      "permissions": [
        "inbox_read"
      ],
      "created_at": "2026-10-18T12:00:00.000Z"
    }
  ]
}
```

## Errors

The summary and the OpenAPI operation do not name an error code.

## Idempotency

This route does not document Idempotency-Key or client_id.