Skip to content
Documentation
GuidesAPI ReferenceIntegrations
ArenaPlatform
API Reference/Trace Export

List Trace Deliveries

GET/v1/traces/destinations/{destination_id}/deliveries

Overview

Requires a dashboard session with read access to the workspace; API keys are rejected. Returns delivery metadata only, newest first: dead letters by default. A dead letter is a trace that failed six attempts or was refused outright; it is kept for 7 days. Delivered traces are kept for 1 day.

Authorization

Authorizationstring · headerRequired

Workspace session token sent as Bearer <token>. Authentication guide

Parameters

destination_idpath · stringRequired

Trace destination ID (trd_…).

workspace_idquery · stringRequired

The destination's workspace; the session must be a member.

statequery · string
limitquery · integer

Responses

200Deliveries in the requested state.
application/json
dataobject[]Required
Show nested fields
idstringRequired

Example: "trv_example"

request_idstringRequired

Example: "lreq_example"

productstring | nullRequired

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

statestringRequired

Values: "pending""delivered""dead"

attemptsintegerRequired
status_codeinteger | nullRequired

HTTP status of the last attempt.

Example: 503

errorstring | nullRequired

Example: "HTTP 503"

created_atstringRequired
finished_atstring | nullRequired
next_attempt_atstring | nullRequired

When a pending delivery is next tried.

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.

404Resource was not found.
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.