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.
Sign inBook a demo
DocsReferenceChangelog
DocsReferenceChangelog
  • Introduction
    • Overview
    • Errors
  • SDK
    • Overview
    • Decorators
    • Run Evaluation
  • API
      • GETList Datasets
      • POSTUpsert Dataset
      • GETGet Dataset
      • DELDelete Dataset
      • PATCHMove Dataset
      • GETList Datapoints
      • GETList Versions of a Dataset
      • DELDelete Dataset Version
      • PATCHUpdate Dataset Version
      • POSTUpload CSV
      • POSTDeploy Dataset
      • DELRemove Deployment
      • GETList a Dataset's Environments
LogoLogo
Sign inBook a demo
APIDatasets

List Datapoints

GET
https://api.humanloop.com/v5/datasets/:id/datapoints
GET
/v5/datasets/:id/datapoints
$curl -G https://api.humanloop.com/v5/datasets/ds_b0baF1ca7652/datapoints \
> -H "X-API-KEY: <apiKey>" \
> -d size=1
1{
2 "records": [
3 {
4 "id": "dp_901stu",
5 "messages": [
6 {
7 "role": "user",
8 "content": "What is the capital of France?"
9 }
10 ],
11 "target": {
12 "answer": "Paris"
13 }
14 },
15 {
16 "id": "dp_234vwx",
17 "messages": [
18 {
19 "role": "user",
20 "content": "Who wrote Hamlet?"
21 }
22 ],
23 "target": {
24 "answer": "William Shakespeare"
25 }
26 }
27 ],
28 "page": 1,
29 "size": 10,
30 "total": 2
31}
List all Datapoints for the Dataset with the given ID.
Was this page helpful?
Previous

List Versions of a Dataset

Next
Built with

Authentication

X-API-KEYstring
API Key authentication via header

Path parameters

idstringRequired
Unique identifier for Dataset.

Query parameters

version_idstringOptional
A specific Version ID of the Dataset to retrieve.
environmentstringOptional
Name of the Environment to retrieve a deployed Version from.
pageintegerOptional>=1Defaults to 1
Page number for pagination.
sizeintegerOptional>=0Defaults to 50
Page size for pagination. Number of Datapoints to fetch.

Response

Successful Response
recordslist of objects
pageinteger
sizeinteger
totalinteger

Errors

422
List Datapoints Datasets ID Datapoints Get Request Unprocessable Entity Error