Sign in
traces

List traces

Retrieve a paginated list of traces matching your filters. Supports the filter payload documented in the Filters API.

post/api/traces/list/

Query parameters

pageinteger

Page number.

page_sizeinteger

Results per page (max 1000).

sort_bystring

Field to sort by. Prefix - for descending. Common values include -timestamp, -total_cost, -duration, -total_tokens, and -error_count.

start_timestring date-time

Start of time range (ISO 8601). Defaults to one hour before end_time when omitted.

end_timestring date-time

End of time range (ISO 8601). Defaults to now when omitted.

environmentstring

Filter by environment.

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Request body

Response

Paginated list of traces.

countinteger required

Total number of matching traces.

nextstring nullable

URL for the next page of results.

previousstring nullable

URL for the previous page of results.

Changes