Skip to main content
GET
/
v1
/
requests
curl "https://api.lumenfall.ai/v1/requests?limit=5" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
      "object": "request",
      "created_at": "2026-03-15T14:32:10.000Z",
      "model": "flux-pro",
      "modality": "image",
      "endpoint": "/openai/v1/images/generations",
      "status": "completed",
      "cost": 0.045,
      "currency": "usd",
      "duration_ms": 2340,
      "key_id": "test_abc123",
      "error_code": null,
      "error_message": null,
      "session_id": null,
      "trace_id": null,
      "user": null,
      "request_size_bytes": 1024,
      "response_size_bytes": 524288
    },
    {
      "id": "req_2m4jKEGfmR8h3UqTGnhHpBNkMOx",
      "object": "request",
      "created_at": "2026-03-15T14:30:05.000Z",
      "model": "gpt-image-1.5",
      "modality": "image",
      "endpoint": "/openai/v1/images/generations",
      "status": "completed",
      "cost": 0.02,
      "currency": "usd",
      "duration_ms": 4120,
      "key_id": "test_abc123",
      "error_code": null,
      "error_message": null,
      "session_id": null,
      "trace_id": null,
      "user": null,
      "request_size_bytes": 512,
      "response_size_bytes": 1048576
    }
  ],
  "next_page_url": "/v1/requests?starting_after=req_2m4jKEGfmR8h3UqTGnhHpBNkMOx&limit=5",
  "previous_page_url": null
}
Returns a paginated list of API requests for your organization, sorted newest first.
This endpoint uses the native Lumenfall API path (/v1/requests), 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 older than the request 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 newer than the request with this ID. Cannot be combined with starting_after.
​
created_after
string
Filter to requests created at or after this time. ISO 8601 datetime (e.g., 2026-03-01T00:00:00Z).
​
created_before
string
Filter to requests created at or before this time. ISO 8601 datetime (e.g., 2026-03-31T23:59:59Z).
​
key_id
string
Filter to requests made with a specific API key ID. You can retrieve your key IDs from the List API keys endpoint.
​
summary
boolean
When true, includes a summary object with the total cost and count of all matching requests (not just the current page).

​
Response

​
object
string
Always list.
​
data
array
Array of request 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.
​
summary
object
Only present when summary=true. Aggregates across all matching requests, not just the current page.
curl "https://api.lumenfall.ai/v1/requests?limit=5" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
      "object": "request",
      "created_at": "2026-03-15T14:32:10.000Z",
      "model": "flux-pro",
      "modality": "image",
      "endpoint": "/openai/v1/images/generations",
      "status": "completed",
      "cost": 0.045,
      "currency": "usd",
      "duration_ms": 2340,
      "key_id": "test_abc123",
      "error_code": null,
      "error_message": null,
      "session_id": null,
      "trace_id": null,
      "user": null,
      "request_size_bytes": 1024,
      "response_size_bytes": 524288
    },
    {
      "id": "req_2m4jKEGfmR8h3UqTGnhHpBNkMOx",
      "object": "request",
      "created_at": "2026-03-15T14:30:05.000Z",
      "model": "gpt-image-1.5",
      "modality": "image",
      "endpoint": "/openai/v1/images/generations",
      "status": "completed",
      "cost": 0.02,
      "currency": "usd",
      "duration_ms": 4120,
      "key_id": "test_abc123",
      "error_code": null,
      "error_message": null,
      "session_id": null,
      "trace_id": null,
      "user": null,
      "request_size_bytes": 512,
      "response_size_bytes": 1048576
    }
  ],
  "next_page_url": "/v1/requests?starting_after=req_2m4jKEGfmR8h3UqTGnhHpBNkMOx&limit=5",
  "previous_page_url": null
}