List Traces

Handle POST requests the same as GET for filtering.

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, 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

idstring required

trace_unique_idstring required

root_span_unique_idstring

unique_organization_idstring

environmentstring

customer_identifierstring

start_timestring date-time

end_timestring date-time

durationnumber double

span_countinteger

llm_call_countinteger

total_costnumber double

total_prompt_tokensinteger

total_completion_tokensinteger

total_tokensinteger

error_countinteger

namestring

inputstring

outputstring

storage_object_keystring

organization_namestring

organization_idstring

organization_key_idstring

{"stackTrail":"components:schemas:CHTraceListRequest:properties:metadata","oasType":"schema","type":"unknown","description":"Any type"}

trace_group_identifierstring

session_identifierstring

modelstring

Response