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
}
Billing
Get a request
Retrieve a single API request by ID
GET
/
v1
/
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
string
required
The ID of the request to retrieve (e.g.,
req_2m4jLFHhkN1i4VrVHpjJqCOKlPw).Response
string
Unique request identifier (e.g.,
req_2m4jLFHhkN1i4VrVHpjJqCOKlPw).string
Always
request.string
When the request started, as an ISO 8601 datetime.
string | null
The model used (e.g.,
flux-pro, gpt-image-1.5).string | null
The request modality -
image, video, speech, or vision.string | null
The API endpoint path (e.g.,
/openai/v1/images/generations).string
Request status -
completed, pending, processing, upstream_failure, rejected, or cancelled.number
Request cost in USD (e.g.,
0.045).string
Always
usd.integer | null
Total response time in milliseconds.
string | null
The API key ID used for this request.
string | null
Error code if the request failed (e.g.,
ALL_PROVIDERS_EXHAUSTED).string | null
Human-readable error message if the request failed.
string | null
Caller-provided session ID for grouping related requests.
string | null
Trace ID extracted from the W3C
traceparent header.string | null
End user identifier from the request body.
integer | null
Size of the request body in 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
}