List dataset examples
List examples for a given dataset and version.
If version is not passed, the latest version is selected. Examples are returned in ascending order of created_at, with id as a tiebreaker. This order is stable across pages, so cursor pagination never skips or repeats an example.
Human annotations: returned in the structured annotations array on each example. Each entry includes name, optional label / score / text / updated_at, and an annotator (id + email) for per-user annotations.
Pagination:
- Response includes pagination with has_more and next_cursor.
- Use cursor-based pagination by passing the returned next_cursor value as the cursor query parameter in subsequent requests.
<Note>This endpoint is in beta, read more here.</Note>
Path parameters
A universally unique identifier (base64-encoded opaque string).
The unique dataset identifier (base64)
Query parameters
A universally unique identifier (base64-encoded opaque string).
The unique identifier of the dataset version
Maximum items to return
Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.
Response
Returns a list of dataset examples as structured objects
Example response
{
"examples": [
{
"annotations": [
{
"annotator": {
"email": "user@example.com"
}
}
]
}
]
}