List requests

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

curl "https://api.lumenfall.ai/v1/requests?created_after=2026-03-01T00:00:00Z&created_before=2026-03-31T23:59:59Z&summary=true" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

import requests

response = requests.get(
    "https://api.lumenfall.ai/v1/requests",
    headers={"Authorization": "Bearer your-lumenfall-api-key"},
    params={
        "limit": 5,
        "created_after": "2026-03-01T00:00:00Z",
        "summary": "true",
    },
)
data = response.json()

for req in data["data"]:
    print(f"{req['created_at']} {req['model']} ${req['cost']}")

# Paginate
while data["next_page_url"]:
    response = requests.get(
        f"https://api.lumenfall.ai{data['next_page_url']}",
        headers={"Authorization": "Bearer your-lumenfall-api-key"},
    )
    data = response.json()
    for req in data["data"]:
        print(f"{req['created_at']} {req['model']} ${req['cost']}")

const baseUrl = "https://api.lumenfall.ai";
const headers = { Authorization: "Bearer your-lumenfall-api-key" };

let url: string | null = `${baseUrl}/v1/requests?limit=5&summary=true`;

while (url) {
  const response = await fetch(url, { headers });
  const data = await response.json();

  for (const req of data.data) {
    console.log(`${req.created_at} ${req.model} $${req.cost}`);
  }

  url = data.next_page_url ? `${baseUrl}${data.next_page_url}` : null;
}

{
  "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
}

{
  "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
    }
  ],
  "next_page_url": "/v1/requests?starting_after=req_2m4jLFHhkN1i4VrVHpjJqCOKlPw&limit=20&summary=true",
  "previous_page_url": null,
  "summary": {
    "total_cost": 12.34,
    "currency": "usd",
    "count": 347
  }
}

GET

requests

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

curl "https://api.lumenfall.ai/v1/requests?created_after=2026-03-01T00:00:00Z&created_before=2026-03-31T23:59:59Z&summary=true" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

import requests

response = requests.get(
    "https://api.lumenfall.ai/v1/requests",
    headers={"Authorization": "Bearer your-lumenfall-api-key"},
    params={
        "limit": 5,
        "created_after": "2026-03-01T00:00:00Z",
        "summary": "true",
    },
)
data = response.json()

for req in data["data"]:
    print(f"{req['created_at']} {req['model']} ${req['cost']}")

# Paginate
while data["next_page_url"]:
    response = requests.get(
        f"https://api.lumenfall.ai{data['next_page_url']}",
        headers={"Authorization": "Bearer your-lumenfall-api-key"},
    )
    data = response.json()
    for req in data["data"]:
        print(f"{req['created_at']} {req['model']} ${req['cost']}")

const baseUrl = "https://api.lumenfall.ai";
const headers = { Authorization: "Bearer your-lumenfall-api-key" };

let url: string | null = `${baseUrl}/v1/requests?limit=5&summary=true`;

while (url) {
  const response = await fetch(url, { headers });
  const data = await response.json();

  for (const req of data.data) {
    console.log(`${req.created_at} ${req.model} $${req.cost}`);
  }

  url = data.next_page_url ? `${baseUrl}${data.next_page_url}` : null;
}

{
  "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
}

{
  "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
    }
  ],
  "next_page_url": "/v1/requests?starting_after=req_2m4jLFHhkN1i4VrVHpjJqCOKlPw&limit=20&summary=true",
  "previous_page_url": null,
  "summary": {
    "total_cost": 12.34,
    "currency": "usd",
    "count": 347
  }
}

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.

status

string

Filter to requests with a specific status. Accepts a single value: completed, pending, processing, upstream_failure, rejected, or cancelled. Matches the status field on each request object.

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.

Show Request object

string

Unique request identifier (e.g., req_2m4jLFHhkN1i4VrVHpjJqCOKlPw).

object

string

Always request.

created_at

string

When the request started, as an ISO 8601 datetime.

model

string | null

The model used (e.g., flux-pro, gpt-image-1.5).

modality

string | null

The request modality - image, video, speech, or vision.

endpoint

string | null

The API endpoint path (e.g., /openai/v1/images/generations).

status

string

Request status - completed, pending, processing, upstream_failure, rejected, or cancelled.

cost

number

Request cost in USD (e.g., 0.045).

currency

string

Always usd.

duration_ms

integer | null

Total response time in milliseconds.

key_id

string | null

The API key ID used for this request.

error_code

string | null

Error code if the request failed (e.g., ALL_PROVIDERS_EXHAUSTED).

error_message

string | null

Human-readable error message if the request failed.

session_id

string | null

Caller-provided session ID for grouping related requests.

trace_id

string | null

Trace ID extracted from the W3C traceparent header.

user

string | null

End user identifier from the request body.

request_size_bytes

integer | null

Size of the request body in bytes.

response_size_bytes

integer | null

Size of the response body in bytes.

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.

Show Summary object

total_cost

number

Total cost of all matching requests in USD.

currency

string

Always usd.

count

integer

Total number of matching requests.

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

curl "https://api.lumenfall.ai/v1/requests?created_after=2026-03-01T00:00:00Z&created_before=2026-03-31T23:59:59Z&summary=true" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

import requests

response = requests.get(
    "https://api.lumenfall.ai/v1/requests",
    headers={"Authorization": "Bearer your-lumenfall-api-key"},
    params={
        "limit": 5,
        "created_after": "2026-03-01T00:00:00Z",
        "summary": "true",
    },
)
data = response.json()

for req in data["data"]:
    print(f"{req['created_at']} {req['model']} ${req['cost']}")

# Paginate
while data["next_page_url"]:
    response = requests.get(
        f"https://api.lumenfall.ai{data['next_page_url']}",
        headers={"Authorization": "Bearer your-lumenfall-api-key"},
    )
    data = response.json()
    for req in data["data"]:
        print(f"{req['created_at']} {req['model']} ${req['cost']}")

const baseUrl = "https://api.lumenfall.ai";
const headers = { Authorization: "Bearer your-lumenfall-api-key" };

let url: string | null = `${baseUrl}/v1/requests?limit=5&summary=true`;

while (url) {
  const response = await fetch(url, { headers });
  const data = await response.json();

  for (const req of data.data) {
    console.log(`${req.created_at} ${req.model} $${req.cost}`);
  }

  url = data.next_page_url ? `${baseUrl}${data.next_page_url}` : null;
}

{
  "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
}

{
  "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
    }
  ],
  "next_page_url": "/v1/requests?starting_after=req_2m4jLFHhkN1i4VrVHpjJqCOKlPw&limit=20&summary=true",
  "previous_page_url": null,
  "summary": {
    "total_cost": 12.34,
    "currency": "usd",
    "count": 347
  }
}

Get balance Get a request

Overview

Images

Videos

Chat

Models

Webhooks

Billing

Query parameters

Response

​Query parameters

​Response

Query parameters

Response