For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • POSTCreate a dataset
      • POSTList datasets
      • GETRetrieve a dataset
      • PATCHUpdate a dataset
      • DELDelete a dataset
      • POSTCreate a dataset log
      • POSTList dataset logs
      • GETRetrieve a dataset log
      • PATCHUpdate a dataset log
      • DELDelete a dataset log
      • POSTBulk create dataset logs
      • POSTRun evaluators on a dataset
      • GETList dataset evaluation runs
      • PUTReplace a dataset log
      • POSTImport existing logs into a dataset
      • DELRemove logs from a dataset
      • GETGet dataset logs summary
      • POSTGet filtered dataset logs summary
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceDatasets

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 sk_live_xxxxx" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "filters": {
>    "name": {
>      "operator": "icontains",
>      "value": "support"
>    }
>  }
>}'
1{
2  "count": 1,
3  "next": null,
4  "previous": null,
5  "results": [
6    {
7      "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
8      "name": "Support Conversations - July",
9      "description": "Sampled support chats for July",
10      "type": "sampling",
11      "status": "ready",
12      "log_count": 250,
13      "created_at": "2025-07-26T00:00:00Z",
14      "organization_id": 123,
15      "updated_by": {
16        "first_name": "Ann",
17        "last_name": "Lee",
18        "email": "ann@example.com"
19      },
20      "log_ids": [
21        "log_abc123",
22        "log_def456"
23      ],
24      "updated_at": "2025-07-27T08:10:00Z",
25      "completed_annotation_count": 0,
26      "running_status": "pending",
27      "running_progress": 0,
28      "starred": false,
29      "tags": [
30        {
31          "id": "8c6b5e58-66bc-4bdb-a660-9ed0b4a14cf1",
32          "name": "support",
33          "color": "blue"
34        }
35      ]
36    }
37  ],
38  "total_count": 1,
39  "current_filters": {},
40  "filters_data": {}
41}
List datasets with pagination and optional filters.
Was this page helpful?
Previous

Retrieve a dataset

Next
Built with

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Query parameters

pageintegerOptionalDefaults to 1
Page number.
page_sizeintegerOptionalDefaults to 25
Results per page.
sort_bystringOptionalDefaults to -created_at

Sort field. Prefix with - for descending order.

Request

This endpoint expects an object.
filtersmap from strings to objectsOptional

Platform-standard filters keyed by field name.

Response

Paginated list of datasets.
countinteger
Total matching datasets.
nextstring or null
Next page URL.
previousstring or null
Previous page URL.
resultslist of objects
Array of dataset objects.
total_countinteger
Total datasets matching the current filters.
current_filtersmap from strings to objects

Platform-standard filters keyed by field name.

filters_dataobject

Errors

401
Unauthorized Error