Skip to main content
GET
/
v1
/
requests
/
{request_id}
curl "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

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

​
id
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"

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