List Datasets

POST

https://api.respan.ai/api/datasets/list/

POST

/api/datasets/list/

$ curl -X POST https://api.respan.ai/api/datasets/list/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

201Created

1 {
2   "count": 25,
3   "results": [
4     {
5       "organization_id": 1,
6       "updated_by": {
7         "id": 1,
8         "email": "string",
9         "name": "string",
10         "username": "string",
11         "first_name": "string",
12         "last_name": "string"
13       },
14       "name": "string",
15       "created_at": "2024-01-15T09:30:00Z",
16       "updated_at": "2024-01-15T09:30:00Z",
17       "completed_annotation_count": 1,
18       "tags": [
19         {
20           "id": "string",
21           "name": "string",
22           "color": "string",
23           "created_at": "2024-01-15T09:30:00Z",
24           "updated_at": "2024-01-15T09:30:00Z"
25         }
26       ],
27       "granularity": "logs",
28       "id": "string",
29       "log_count": 1,
30       "log_ids": [
31         "string"
32       ],
33       "description": "string",
34       "type": "llm",
35       "status": "initializing",
36       "running_status": "draft",
37       "running_progress": 1.1,
38       "starred": true
39     }
40   ],
41   "next": "string",
42   "previous": "string",
43   "total_count": 100,
44   "current_filters": {},
45   "filters_data": {}
46 }

List datasets with complex filtering via POST body.

Authentication

AuthorizationBearer

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.

Query parameters

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Request

This endpoint expects an object.

filtersmap from strings to anyOptional

Filter parameters keyed by metric name.

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