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

Retrieve a dataset

GET
https://api.respan.ai/api/datasets/:dataset_id/
GET
/api/datasets/:dataset_id/
$curl https://api.respan.ai/api/datasets/dataset_id/ \
>     -H "Authorization: Bearer sk_live_xxxxx"
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}
Retrieve a dataset by ID.
Was this page helpful?
Previous

Update a dataset

Next
Built with

Path parameters

dataset_idstringRequired
Dataset Id

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

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