Sign in
experiments

Filter experiment traces

List experiment traces using POST-for-filtering. Supports status, cost, comparison key, timestamp, metadata, and score filters.

post/api/v2/experiments/{experiment_id}/logs/list/

Path parameters

experiment_idstring required

Experiment ID returned as id in experiment responses.

Query parameters

pageinteger

Page number.

page_sizeinteger

Number of results to return per page. Maximum 100.

sort_bystring

Field to sort by. Prefix with - for descending order.

start_timestring date-time

Filter results at or after this timestamp.

end_timestring date-time

Filter results before this timestamp.

detail'1' | 'true'

Set to 1 or true to include span tree details in list responses.

preview_lengthinteger

Truncate input, expected_output, and output to this many characters. Omitted, non-positive, or unparseable values return full text; ignored when detail is set.

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

filtersApiV2ExperimentsExperimentIdLogsListPostRequestBodyContentApplicationJsonSchemaFilters

Filter criteria using the standard Respan filter format.

is_exportingboolean

Reserved for dashboard exports.

Response

Paginated filtered list of experiment traces.

countinteger required

Total number of matching results.

nextstring nullable

URL for the next page, if any.

previousstring nullable

URL for the previous page, if any.

current_filtersApiV2ExperimentsExperimentIdLogsListPostResponsesContentApplicationJsonSchemaCurrentFilters

Normalized filters applied to this request.

Changes

No recorded changes to this endpoint across all 1 revision of this API.