Skip to main content
GET
/
v2
/
experiments
/
{experimentId}
Get an experiment
curl --request GET \
  --url https://api.arize.com/v2/experiments/{experimentId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "datasetId": "<string>",
  "datasetVersionId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "experimentTracesProjectId": "<string>"
}

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

Authorization: Bearer <api-key>

Path Parameters

​
experimentId
string
required

The unique identifier of the experiment A universally unique identifier

Response

An experiment object

Experiments combine a dataset (example inputs/expected outputs), a task (the function that produces model outputs), and one or more evaluators (code or LLM judges) to measure performance. Each run is stored independently so you can compare runs, track progress, and validate improvements over time. See the full definition on the Experiments page.

Use an experiment to run tasks on a dataset, attach evaluators to score outputs, and compare runs to confirm improvements.

​
id
string
required

Unique identifier for the experiment

​
name
string
required

Name of the experiment

​
datasetId
string
required

Unique identifier for the dataset this experiment belongs to

​
datasetVersionId
string
required

Unique identifier for the dataset version this experiment belongs to

​
createdAt
string<date-time>
required

Timestamp for when the experiment was created

​
updatedAt
string<date-time>
required

Timestamp for the last update of the experiment

​
experimentTracesProjectId
string

Unique identifier for the experiment traces project this experiment belongs to (if it exists)