Sign in
spans

List spans

Retrieve spans matching the specified filters with pagination. Supports filtering by any span field, URL-based quick filters, and sorting by evaluator scores. See Filters API Reference for full filter syntax.

post/api/request-logs/list/

Query parameters

pageinteger

Page number.

page_sizeinteger

Results per page (max 1000).

sort_bystring

Field to sort by. Prefix - for descending.

start_timestring date-time

Start of time range (ISO 8601).

end_timestring date-time

End of time range (ISO 8601).

environment'prod' | 'test'

Filter by environment (prod or test).

log_type'text' | 'chat' | 'completion' | 'response' | 'embedding' | 'transcription' | 'speech' | 'workflow' | 'task' | 'tool' | 'agent' | 'handoff' | 'guardrail' | 'function' | 'custom' | 'generation' | 'unknown' | 'score' | 'batch' | 'span'

Filter by span/log type. Use values like chat, completion, or response to focus on model-inference spans; omitting this can also return non-chat span/log rows such as legacy text logs.

include_fieldsstring

Comma-separated list of fields to include in each span. Reduces response size.

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

Successful response for List spans

countinteger required

Total number of results

nextstring nullable

URL for the next page of results

previousstring nullable

URL for the previous page of results

resultsApiRequestLogsListPostResponsesContentApplicationJsonSchemaResultsItems[] required

Array of results for the current page

Changes