Experiments

List experiment runs

Changed on

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.
get/v2/experiments/{experiment_id}/runs

Request

  • Base URL
    https://api.arize.com
  • URL
    https://api.arize.com/v2/experiments/{experiment_id}/runs
  • Auth
    HTTP bearer

Path parameters

experiment_idstring required

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

Example:RW50aXR5OjEyMzQ1

The unique experiment identifier (base64)

Query parameters

limitinteger

Maximum items to return. Defaults to 50 if omitted; maximum is 500.

cursorstring

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 experiment run objects

Example response

{
  "experiment_runs": [
    {
      "annotations": [
        {
          "annotator": {
            "email": "user@example.com"
          }
        }
      ]
    }
  ]
}

Changes

  • 4f94eb2fd1abRevision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became optional for the status

    • breaking

      the response property // became optional for the status

    • info

      api operation id experiments_runs_list removed and replaced with list_experiment_runs

    • info

      added the new optional query request parameter cursor

    • info

      removed the non-success response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status