List experiment runs

List runs for a given experiment.

The runs are returned in a stable insertion order.

Human annotations: returned in the structured annotations array on each run. 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.

This endpoint is in beta, read more here.

GET /v2/experiments/{experiment_id}/runs

List experiment runs

cURL

curl --request GET \
  --url https://api.arize.com/v2/experiments/{experiment_id}/runs \
  --header 'Authorization: Bearer <token>'

200

{
  "experiment_runs": [
    {
      "id": "run_001",
      "example_id": "550e8400-e29b-41d4-a716-446655440000",
      "output": "4",
      "latency_ms": 120,
      "model": "gpt-4"
    },
    {
      "id": "run_002",
      "example_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "output": "4",
      "latency_ms": 150,
      "model": "gpt-4"
    },
    {
      "id": "run_003",
      "example_id": "9c7f6b2e-4a3d-11e9-8bad-f5b7b8c1ae7e",
      "output": "3",
      "latency_ms": 130,
      "model": "gpt-4"
    }
  ],
  "pagination": {
    "next_cursor": "cursor_12345",
    "has_more": true
  }
}

Authorizations

Authorization · string · header · required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Path Parameters

experiment_id · string · required

The unique experiment identifier (base64) A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Query Parameters

limit · integer · default: 50

Maximum items to return

Required range: 1 <= x <= 500

cursor · string

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

200

application/json

Returns a list of experiment run objects

experiment_runs · object[] · required

Array of experiment run objects containing experiment fields and evaluations

Show child attributes

pagination · object · required

Pagination metadata for cursor-based navigation

Show child attributes