List Datasets | Humanloop Docs

List all Datasets.

X-API-KEYstring

API Key authentication via header

pageintegerOptional>=1Defaults to 1

Page offset for pagination.

sizeintegerOptional>=0Defaults to 10

Page size for pagination. Number of Datasets to fetch.

namestringOptional

Case-insensitive filter for Dataset name.

user_filterstringOptional

Case-insensitive filter for users in the Dataset. This filter matches against both email address and name of users.

sort_byenumOptional

Field to sort Datasets by

Allowed values:

orderenumOptional

Direction to sort by.

Allowed values:

Successful Response

recordslist of objects

pageinteger

sizeinteger

totalinteger

422

List Datasets Get Request Unprocessable Entity Error

1	{
2	"records": [
3	{
4	"path": "test-questions",
5	"id": "ds_345mno",
6	"name": "test-questions",
7	"version_id": "dsv_678pqr",
8	"created_at": "2024-05-01T12:00:00Z",
9	"updated_at": "2024-05-01T12:00:00Z",
10	"last_used_at": "2024-05-01T12:00:00Z",
11	"datapoints_count": 2,
12	"type": "dataset",
13	"created_by": {
14	"id": "usr_v23rSVAgas2a",
15	"full_name": "Jordan Burges",
16	"email_address": "jordan@humanloop.com"
17	}
18	}
19	],
20	"page": 0,
21	"size": 1,
22	"total": 1
23	}

1	{
2	"records": [
3	{
4	"path": "test-questions",
5	"id": "ds_345mno",
6	"name": "test-questions",
7	"version_id": "dsv_678pqr",
8	"created_at": "2024-05-01T12:00:00Z",
9	"updated_at": "2024-05-01T12:00:00Z",
10	"last_used_at": "2024-05-01T12:00:00Z",
11	"datapoints_count": 2,
12	"type": "dataset",
13	"created_by": {
14	"id": "usr_v23rSVAgas2a",
15	"full_name": "Jordan Burges",
16	"email_address": "jordan@humanloop.com"
17	}
18	}
19	],
20	"page": 0,
21	"size": 1,
22	"total": 1
23	}

$	curl -G https://api.humanloop.com/v5/datasets \
>	-H "X-API-KEY: <apiKey>" \
>	-d size=1