Skip to main content
GET
Get a list of evaluation runs

Authorizations

Authorization
string
header
required

A fine-grained data plane API key (values begin with hh_fgdp_). Rooted at an organization, workspace, or project, it carries the permissions chosen when it was created, and only the operations whose paths begin with /v1/projects/{project_id}/ accept it. Create one in the HoneyHive app under the project's, workspace's, or organization's Settings → API Keys, on the Data Plane tab.

Path Parameters

project_id
string
required

The unique identifier of the project whose runs are listed

Query Parameters

dataset_id
string

Filter by dataset ID

page
integer
default:1

Page number for pagination

Required range: x >= 1
limit
integer
default:20

Number of results per page

Required range: 1 <= x <= 100
run_ids
string[]

List of specific run IDs to fetch

name
string

Filter by run name

status
enum<string>

Filter by run status

Available options:
pending,
completed,
failed,
cancelled,
running
dateRange

Filter by date range

sort_by
enum<string>
default:created_at

Field to sort by

Available options:
created_at,
updated_at,
name,
status
sort_order
enum<string>
default:desc

Sort order

Available options:
asc,
desc

Response

Successful response

Response for GET /runs

evaluations
object[]
required
pagination
object
required
metrics
string[]
required