Skip to main content

CursorPageInfo

Opaque-cursor pagination details. A cursor is used to request the next page; arbitrary page-number seeking is not supported.

Usage profiles​

UsageFields and validation
In responsesView fields

In responses​

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
nextCursorstringOptionalPass back as the request's cursor for the next page. Empty on the last page.
limitinteger (int32)OptionalMaximum number of entries requested from the listing. Minimum: -2147483648. Maximum: 2147483647.
totalItemsinteger (int32)Optional; explicit presenceTotal number of matching items when it can be counted exactly. Absent when the selected filters do not support an exact total. Minimum: -2147483648. Maximum: 2147483647.

Where used​

ReferenceRelationship
List dataset runsPOST /api/v1/evals/list-dataset-runs
List observationsPOST /api/v1/evals/list-observations
List scoresPOST /api/v1/evals/list-scores
List sessionsPOST /api/v1/evals/list-sessions
List tracesPOST /api/v1/evals/list-traces

Download the public reference contract.

Document: DOC-API-MODEL-cursor-page-info.