Billing
Get a request
Retrieve a single API request by ID
GET
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.