Skip to main content
GET
List evaluations

Authorizations

Authorization
string
header
required

Workspace API key. Pass as Authorization: Bearer <key>.

Path Parameters

promptId
string
required

Unique identifier for an entity, between 20 and 80 characters.

Required string length: 20 - 80

Query Parameters

status
enum<string>

The current status of an evaluation run.

Available options:
queued,
running,
completed,
failed,
cancelled,
cancelling
evaluatorId
string

Unique identifier for an entity, between 20 and 80 characters.

Required string length: 20 - 80
datasetId
string

Unique identifier for an entity, between 20 and 80 characters.

Required string length: 20 - 80
sort
enum<string>

Sort order for list endpoints.

Available options:
createdAt:asc,
createdAt:desc
createdAfter
integer | null
Required range: x >= 0
createdBefore
integer | null
Required range: x >= 0
limit
integer
Required range: x <= 200
cursor
string
Minimum string length: 1

Response

Evaluations retrieved.

Paginated list of evaluations.

evaluations
Evaluation · object[]
required
pagination
Pagination · object
required

Pagination metadata for list endpoints with cursor-based navigation.