API ReferenceDatasets

Retrieve a dataset

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

OR
AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

idstringRequired
Dataset ID.

Response

Successful response for Retrieve dataset
idstringOptional
namestringOptional
typestringOptional
descriptionstringOptional
created_atstringOptional
updated_atstringOptional
organizationintegerOptional
initial_log_filtersobjectOptional
unique_organization_idslist of stringsOptional
timestampslist of stringsOptional
log_countintegerOptional
evaluatorstring or nullOptional
statusstringOptional
running_statusstringOptional
running_progressintegerOptional
running_atstring or nullOptional
completed_annotation_countintegerOptional
granularityenumOptionalRead-onlyDefaults to logs
Evaluation unit. Immutable after dataset creation.

Errors

401
Unauthorized Error