Retrieve dataset | Respan Docs

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

{
  "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
  "name": "Support Conversations - July",
  "type": "sampling",
  "description": "Sampled support chats for July",
  "created_at": "2025-07-26T00:00:00Z",
  "updated_at": "2025-07-27T08:10:00Z",
  "organization": 123,
  "initial_log_filters": {
    "status_code": {
      "operator": "eq",
      "value": 200
    }
  },
  "unique_organization_ids": [],
  "timestamps": [],
  "log_count": 250,
  "status": "ready",
  "running_status": "pending",
  "running_progress": 0,
  "completed_annotation_count": 0
}

Authentication

API key: Authorization: Bearer

Response (200 OK):

1 {
2   "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
3   "name": "Support Conversations - July",
4   "type": "sampling",
5   "description": "Sampled support chats for July",
6   "created_at": "2025-07-26T00:00:00Z",
7   "updated_at": "2025-07-27T08:10:00Z",
8   "organization": 123,
9   "initial_log_filters": { "status_code": { "operator": "eq", "value": 200 } },
10   "unique_organization_ids": [],
11   "timestamps": [],
12   "log_count": 250,
13   "evaluator": null,
14   "status": "ready",
15   "running_status": "pending",
16   "running_progress": 0,
17   "running_at": null,
18   "completed_annotation_count": 0
19 }

Errors:

401 Unauthorized — Missing/invalid authentication
404 Not Found — Dataset not found or not in your organization

## Authentication - API key: `Authorization: Bearer ` Response (200 OK): ```json { "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a", "name": "Support Conversations - July", "type": "sampling", "description": "Sampled support chats for July", "created_at": "2025-07-26T00:00:00Z", "updated_at": "2025-07-27T08:10:00Z", "organization": 123, "initial_log_filters": { "status_code": { "operator": "eq", "value": 200 } }, "unique_organization_ids": [], "timestamps": [], "log_count": 250, "evaluator": null, "status": "ready", "running_status": "pending", "running_progress": 0, "running_at": null, "completed_annotation_count": 0 } ``` Errors: - 401 Unauthorized — Missing/invalid authentication - 404 Not Found — Dataset not found or not in your organization

Authentication

AuthorizationBearer

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

Path parameters

dataset_idstringRequired

Dataset Id

Response

Successful response for Retrieve dataset

idstring

namestring

typestring

descriptionstring

created_atstring

updated_atstring

organizationinteger

initial_log_filtersobject

unique_organization_idslist of strings

timestampslist of strings

log_countinteger

evaluatorstring

statusstring

running_statusstring

running_progressinteger

running_atstring

completed_annotation_countinteger

Errors

401

Unauthorized Error

Authentication

API key: Authorization: Bearer

Response (200 OK):

1 {
2   "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
3   "name": "Support Conversations - July",
4   "type": "sampling",
5   "description": "Sampled support chats for July",
6   "created_at": "2025-07-26T00:00:00Z",
7   "updated_at": "2025-07-27T08:10:00Z",
8   "organization": 123,
9   "initial_log_filters": { "status_code": { "operator": "eq", "value": 200 } },
10   "unique_organization_ids": [],
11   "timestamps": [],
12   "log_count": 250,
13   "evaluator": null,
14   "status": "ready",
15   "running_status": "pending",
16   "running_progress": 0,
17   "running_at": null,
18   "completed_annotation_count": 0
19 }

Errors:

401 Unauthorized — Missing/invalid authentication
404 Not Found — Dataset not found or not in your organization

1	{
2	"id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
3	"name": "Support Conversations - July",
4	"type": "sampling",
5	"description": "Sampled support chats for July",
6	"created_at": "2025-07-26T00:00:00Z",
7	"updated_at": "2025-07-27T08:10:00Z",
8	"organization": 123,
9	"initial_log_filters": { "status_code": { "operator": "eq", "value": 200 } },
10	"unique_organization_ids": [],
11	"timestamps": [],
12	"log_count": 250,
13	"evaluator": null,
14	"status": "ready",
15	"running_status": "pending",
16	"running_progress": 0,
17	"running_at": null,
18	"completed_annotation_count": 0
19	}