Skip to main content
GET
/
v1
/
keys
curl "https://api.lumenfall.ai/v1/keys" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "2m4jLFHhkN1i4VrVHpjJqCOKlPw",
      "object": "key",
      "name": "Production",
      "last_four": "a1b2",
      "status": "active",
      "created_at": "2026-03-10T09:15:00.000Z",
      "revoked_at": null
    },
    {
      "id": "2m4jKEGfmR8h3UqTGnhHpBNkMOx",
      "object": "key",
      "name": "Staging",
      "last_four": "c3d4",
      "status": "revoked",
      "created_at": "2026-02-01T12:00:00.000Z",
      "revoked_at": "2026-03-05T18:30:00.000Z"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}
Returns a paginated list of API keys for your organization, sorted newest first.
This endpoint uses the native Lumenfall API path (/v1/keys), not the OpenAI-compatible prefix (/openai/v1).

​
Query parameters

​
limit
integer
default:"20"
Number of results to return per page. Minimum 1, maximum 100.
​
starting_after
string
Cursor for forward pagination. Returns results after the key with this ID. Use the next_page_url from a previous response instead of constructing this manually.
​
ending_before
string
Cursor for backward pagination. Returns results before the key with this ID. Cannot be combined with starting_after.
​
status
string
Filter keys by status. One of active or revoked. When omitted, both active and revoked keys are returned.

​
Response

​
object
string
Always list.
​
data
array
Array of key objects, sorted newest first.
​
next_page_url
string | null
URL to fetch the next page of results. null when there are no more results. Includes all original filters so you can follow it directly.
​
previous_page_url
string | null
URL to fetch the previous page of results. null when on the first page.
curl "https://api.lumenfall.ai/v1/keys" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "2m4jLFHhkN1i4VrVHpjJqCOKlPw",
      "object": "key",
      "name": "Production",
      "last_four": "a1b2",
      "status": "active",
      "created_at": "2026-03-10T09:15:00.000Z",
      "revoked_at": null
    },
    {
      "id": "2m4jKEGfmR8h3UqTGnhHpBNkMOx",
      "object": "key",
      "name": "Staging",
      "last_four": "c3d4",
      "status": "revoked",
      "created_at": "2026-02-01T12:00:00.000Z",
      "revoked_at": "2026-03-05T18:30:00.000Z"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}