Get a request

curl "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

import requests

response = requests.get(
    "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
    headers={"Authorization": "Bearer your-lumenfall-api-key"},
)
req = response.json()
print(f"{req['created_at']} {req['model']} {req['status']} ${req['cost']}")

const response = await fetch(
  "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
  { headers: { Authorization: "Bearer your-lumenfall-api-key" } }
);
const req = await response.json();
console.log(`${req.created_at} ${req.model} ${req.status} $${req.cost}`);

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

GET

requests

{request_id}

curl "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

import requests

response = requests.get(
    "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
    headers={"Authorization": "Bearer your-lumenfall-api-key"},
)
req = response.json()
print(f"{req['created_at']} {req['model']} {req['status']} ${req['cost']}")

const response = await fetch(
  "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
  { headers: { Authorization: "Bearer your-lumenfall-api-key" } }
);
const req = await response.json();
console.log(`${req.created_at} ${req.model} ${req.status} $${req.cost}`);

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

Returns a single request from your organization by its ID. The request object matches one element of the List requests endpoint’s data array.

This endpoint uses the native Lumenfall API path (/v1/requests), not the OpenAI-compatible prefix (/openai/v1).

Path parameters

request_id

string

required

The ID of the request to retrieve (e.g., req_2m4jLFHhkN1i4VrVHpjJqCOKlPw).

Response

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.

curl "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

import requests

response = requests.get(
    "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
    headers={"Authorization": "Bearer your-lumenfall-api-key"},
)
req = response.json()
print(f"{req['created_at']} {req['model']} {req['status']} ${req['cost']}")

const response = await fetch(
  "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
  { headers: { Authorization: "Bearer your-lumenfall-api-key" } }
);
const req = await response.json();
console.log(`${req.created_at} ${req.model} ${req.status} $${req.cost}`);

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

List requests Purge request payloads

Overview

Images

Videos

Chat

Models

Webhooks

Billing

Path parameters

Response

​Path parameters

​Response

Path parameters

Response