Skip to content
Documentation
GuidesAPI ReferenceIntegrations
ArenaPlatform
API Reference/Requests and Logs

List Request Logs

GET/v1/logs

Overview

Returns recorded inference metadata, including failed and pending requests. Session callers must provide workspace_id and have read access. API keys require requests.read and can only read their own workspace. No prompts, audio, internal routing traces or provider costs are returned. Rejections before request creation and requests already removed by retention are not included. A null cost or unconfirmed outcome is not evidence of success.

Authorization

Authorizationstring · headerRequired

AudioLab API key sent as Bearer <token>. Authentication guide

Parameters

workspace_idquery · string

Required for sessions; must match an API key's workspace when supplied.

request_idquery · string

Exact request ID, including historical generation IDs.

searchquery · string

Literal substring of request ID, model, provider or key name.

taskquery · string
statequery · string
key_idquery · string
afterquery · string

Inclusive creation time lower bound.

beforequery · string

Exclusive creation time upper bound.

limitquery · integer
cursorquery · string

Opaque cursor from the previous page; retain the same workspace and filters.

Responses

200Request metadata ordered newest first, with deterministic pagination.
application/json
dataobject[]Required
Show nested fields
idstringRequired
sourcestringRequired

Values: "audio""llm""legacy""moderation""images""videos""secondary"

workspace_idstringRequired
key_idstring | nullRequired
key_namestring | nullRequired
taskstringRequired

A product, as request logs, exports and trace destinations filter by it.

Values: "speech""transcription""s2s""llm""embeddings""moderation""images""videos""ocr""rerank""inference"

modelstringRequired
resolved_modelstring | nullRequired
providerstring | nullRequired
statestringRequired

Values: "queued""running""succeeded""failed""canceled""unknown"

costnumber | nullRequired

Settled customer cost in USD when known.

input_tokensinteger | nullRequired
output_tokensinteger | nullRequired
input_charsinteger | nullRequired
audio_secondsnumber | nullRequired
duration_msnumber | nullRequired

Time from request creation to completion when known; legacy entries use reported latency.

protocolstring | nullRequired
streamedboolean | nullRequired
error_codestring | nullRequired
created_atstringRequired
completed_atstring | nullRequired
next_cursorstring | nullRequired
400Request validation failed.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

401Authentication is missing or invalid.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

403Authenticated principal lacks permission.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

500Internal server error.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.