Sign in
experiments

Filter experiments

List experiments using POST-for-filtering.

post/api/v2/experiments/list/

Query parameters

pageinteger

Page number.

page_sizeinteger

Number of results to return per page. Maximum 100.

sort_bystring

Field to sort by. Defaults to -created_at.

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

filtersApiV2ExperimentsListPostRequestBodyContentApplicationJsonSchemaFilters

Filter criteria using the standard Respan filter format.

is_exportingboolean

Reserved for dashboard exports.

Response

Paginated filtered list of experiments.

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_filtersApiV2ExperimentsListPostResponsesContentApplicationJsonSchemaCurrentFilters

Normalized filters applied to this request.

Changes