Skip to main content
GET
List Datasets
Legacy Dataset, Evaluation, and Report endpoints are deprecated for new workflows. Use the Tables API for new dataset import, evaluation, scoring, recalculation, and reporting workflows.
Retrieve a paginated list of datasets based on various filtering criteria. This endpoint allows you to retrieve datasets with various filtering options including dataset group, prompt, report, workspace, and name filters.

Authorizations

X-API-KEY
string
header
required

Query Parameters

dataset_group_id
integer

Filter by specific dataset group ID

Required range: x >= 1
prompt_id
integer

Filter by specific prompt ID

Required range: x >= 1
prompt_version_id
integer

Filter by specific prompt version ID

Required range: x >= 1
prompt_label_id
integer

Filter by specific prompt label ID

Required range: x >= 1
workspace_id
integer

Filter by specific workspace ID. If not provided, uses the current user's workspace

Required range: x >= 1
report_id
integer

Filter by specific report ID (includes parent report ID)

Required range: x >= 1
name
string

Filter datasets by name (case-insensitive partial match on dataset group name)

status
enum<string>
default:active

Filter datasets by status: 'active' (default) returns only active datasets, 'deleted' returns only deleted/archived datasets, 'all' returns both

Available options:
active,
deleted,
all
page
integer
default:1

Page number for pagination

Required range: x >= 1
per_page
integer
default:10

Number of items per page

Required range: 1 <= x <= 100
created_by_email
string

Filter by the creator's email address.

created_after
string<date-time>

Filter resources created at or after this timestamp.

created_before
string<date-time>

Filter resources created at or before this timestamp.

updated_after
string<date-time>

Filter resources updated at or after this timestamp.

updated_before
string<date-time>

Filter resources updated at or before this timestamp.

external_source
string

External ID source to filter by. Must be provided with external_id.

external_id
string

External ID value to filter by. Must be provided with external_source.

sort_by
enum<string>

Sort field.

Available options:
created_at,
updated_at,
name,
id
sort_order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc

Response

Successful response

success
boolean
required
message
string
required
datasets
Dataset · object[]
required
page
integer
required
per_page
integer
required
total
integer
required
pages
integer
required