4e064cf81dae
latestOpenAPI 3.1.02026-08-131831,331960.0 KBList traces
Retrieve a paginated list of traces matching your filters. Supports the filter payload documented in the Filters API. Metadata keys beginning with _ are reserved for platform use and are omitted from customer-facing span and trace responses, so they do not round-trip through read APIs.
Query parameters
Page number.
Results per page (max 1000).
Field to sort by. Prefix - for descending. Common values include -timestamp, -total_cost, -duration, -total_tokens, and -error_count.
Start of time range (ISO 8601). Defaults to one hour before end_time when omitted.
End of time range (ISO 8601). Defaults to now when omitted.
Filter by environment.
Headers
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, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.
Request body
Response
Paginated list of traces.