List datasets | Respan Docs

import requests
url = "https://api.respan.ai/api/datasets/list/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "count": 1,
  "results": [
    {
      "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
      "organization_id": 123,
      "updated_by": {
        "first_name": "Ann",
        "last_name": "Lee",
        "email": "ann@example.com"
      },
      "log_count": 250,
      "name": "Support Conversations - July",
      "log_ids": [
        "..."
      ],
      "description": "Sampled support chats for July",
      "type": "sampling",
      "status": "ready",
      "created_at": "2025-07-26T00:00:00Z",
      "updated_at": "2025-07-27T08:10:00Z",
      "completed_annotation_count": 0,
      "running_status": "pending",
      "running_progress": 0
    }
  ]
}

Authentication

API key: Authorization: Bearer

Response (200 OK):

1 {
2   "count": 1,
3   "next": null,
4   "previous": null,
5   "results": [
6     {
7       "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
8       "organization_id": 123,
9       "updated_by": {
10         "first_name": "Ann",
11         "last_name": "Lee",
12         "email": "ann@example.com"
13       },
14       "log_count": 250,
15       "name": "Support Conversations - July",
16       "log_ids": ["..."],
17       "description": "Sampled support chats for July",
18       "type": "sampling",
19       "status": "ready",
20       "created_at": "2025-07-26T00:00:00Z",
21       "updated_at": "2025-07-27T08:10:00Z",
22       "completed_annotation_count": 0,
23       "running_status": "pending",
24       "running_progress": 0
25     }
26   ]
27 }

Errors:

401 Unauthorized — Missing/invalid authentication

## Authentication - API key: `Authorization: Bearer ` Response (200 OK): ```json { "count": 1, "next": null, "previous": null, "results": [ { "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a", "organization_id": 123, "updated_by": { "first_name": "Ann", "last_name": "Lee", "email": "ann@example.com" }, "log_count": 250, "name": "Support Conversations - July", "log_ids": ["..."], "description": "Sampled support chats for July", "type": "sampling", "status": "ready", "created_at": "2025-07-26T00:00:00Z", "updated_at": "2025-07-27T08:10:00Z", "completed_annotation_count": 0, "running_status": "pending", "running_progress": 0 } ] } ``` Errors: - 401 Unauthorized — Missing/invalid authentication

Authentication

AuthorizationBearer

API key authentication. Get your API key from https://platform.respan.ai/platform/api-keys

Response

Successful response for List datasets

countinteger

nextstring

previousstring

resultslist of objects

Errors

401

Unauthorized Error

Authentication

API key: Authorization: Bearer

Response (200 OK):

1 {
2   "count": 1,
3   "next": null,
4   "previous": null,
5   "results": [
6     {
7       "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
8       "organization_id": 123,
9       "updated_by": {
10         "first_name": "Ann",
11         "last_name": "Lee",
12         "email": "ann@example.com"
13       },
14       "log_count": 250,
15       "name": "Support Conversations - July",
16       "log_ids": ["..."],
17       "description": "Sampled support chats for July",
18       "type": "sampling",
19       "status": "ready",
20       "created_at": "2025-07-26T00:00:00Z",
21       "updated_at": "2025-07-27T08:10:00Z",
22       "completed_annotation_count": 0,
23       "running_status": "pending",
24       "running_progress": 0
25     }
26   ]
27 }

Errors:

401 Unauthorized — Missing/invalid authentication

1	{
2	"count": 1,
3	"next": null,
4	"previous": null,
5	"results": [
6	{
7	"id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
8	"organization_id": 123,
9	"updated_by": {
10	"first_name": "Ann",
11	"last_name": "Lee",
12	"email": "ann@example.com"
13	},
14	"log_count": 250,
15	"name": "Support Conversations - July",
16	"log_ids": ["..."],
17	"description": "Sampled support chats for July",
18	"type": "sampling",
19	"status": "ready",
20	"created_at": "2025-07-26T00:00:00Z",
21	"updated_at": "2025-07-27T08:10:00Z",
22	"completed_annotation_count": 0,
23	"running_status": "pending",
24	"running_progress": 0
25	}
26	]
27	}