Api V 2 Experiments List List

GET

https://api.respan.ai/api/v2/experiments/list/

GET

/api/v2/experiments/list/

$ curl https://api.respan.ai/api/v2/experiments/list/ \
>      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "count": 25,
3   "results": [
4     {
5       "dataset_name": "string",
6       "model": "string",
7       "created_at": "2024-01-15T09:30:00Z",
8       "tags": [
9         {
10           "id": "string",
11           "name": "string",
12           "color": "string",
13           "created_at": "2024-01-15T09:30:00Z",
14           "updated_at": "2024-01-15T09:30:00Z"
15         }
16       ],
17       "prompt_name": "string",
18       "evaluator_names": [
19         "string"
20       ],
21       "evaluator_scores": [
22         {}
23       ],
24       "id": "string",
25       "name": "string",
26       "dataset": "string",
27       "workflow_count": 1,
28       "status": "draft",
29       "progress": 1.1,
30       "started_at": "2024-01-15T09:30:00Z",
31       "completed_at": "2024-01-15T09:30:00Z",
32       "description": "string",
33       "is_starred": true
34     }
35   ],
36   "next": "string",
37   "previous": "string",
38   "total_count": 100,
39   "current_filters": {},
40   "filters_data": {}
41 }

GET: List experiments with filters POST: List experiments with filters (same as GET, but accepts filter payload in body)

Special endpoint for filtered listing. The main endpoint /experiments/ handles GET (list) + POST (create) operations.

Authentication:

Supports both JWT (internal) and API Key (public) authentication

GET: List experiments with filters POST: List experiments with filters (same as GET, but accepts filter payload in body) Special endpoint for filtered listing. The main endpoint `/experiments/` handles GET (list) + POST (create) operations. **Authentication:** - Supports both JWT (internal) and API Key (public) authentication

Authentication

AuthorizationBearer

JWT access token or Respan API key

Query parameters

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Response

countinteger

resultslist of objects

nextstring or nullformat: "uri"

previousstring or nullformat: "uri"

total_countinteger

current_filtersobject

Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters.

Each key is a metric name (str), and each value can be:

A single MetricFilterParamPydantic (one condition)
A List[MetricFilterParamPydantic] (multiple conditions for same metric)
A FilterBundlePydantic (nested filter bundle with connector)

Note: Uses extra=“allow” for dynamic metric name fields. The pydantic_extra annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.

filters_dataobject