Skip to main content
GET
/
beta
/
dataset
/
{dataset_id}
/
split
/
{split_id}
/
sample
List samples
curl --request GET \
  --url https://api.friendli.ai/beta/dataset/{dataset_id}/split/{split_id}/sample \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    [
      "<string>",
      "<string>"
    ]
  ],
  "nextCursor": "<string>"
}
List samples. To request successfully, it is required to enter a Personal API Key (e.g. flp_XXX) in the Bearer Token field. Refer to the authentication section on our introduction page to learn more and visit here to generate your API Key.
This API is currently in Beta. While we strive to provide a stable and reliable experience, this feature is still under active development. As a result, you may encounter unexpected behavior or limitations. We encourage you to provide feedback to help us improve the feature before its official release.

Authorizations

​
Authorization
string
header
required

When using Friendli Suite API for inference requests, you need to provide a Friendli Token for authentication and authorization purposes.

For more detailed information, please refer here.

Headers

​
X-Friendli-Team
string | null

ID of team to run requests as (optional parameter).

Path Parameters

​
dataset_id
string
required

ID of the dataset.

​
split_id
string
required

ID of the split.

Query Parameters

​
cursor
file | null
​
limit
integer | null
default:20
Required range: 1 <= x <= 100
​
direction
enum<string> | null
Available options:
asc,
desc
​
versionId
string | null

Response

OK

List samples response.

​
data
tuple[]
required

List of items.

​
nextCursor
file | null

Next cursor to use for pagination. None indicates no more items to fetch.

Last modified on June 9, 2026