Retrieve a dataset

GET

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

Retrieve a dataset by ID.

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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

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

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": {
10	"status_code": {
11	"operator": "eq",
12	"value": 200
13	}
14	},
15	"unique_organization_ids": [],
16	"timestamps": [],
17	"log_count": 250,
18	"status": "ready",
19	"running_status": "pending",
20	"running_progress": 0,
21	"completed_annotation_count": 0
22	}

$	curl https://api.respan.ai/api/datasets/dataset_id/ \
>	-H "Authorization: Bearer <respanApiKey>"