Skip to main content
GET
/
v2
/
tasks
/
{task_id}
/
runs
List task runs
curl --request GET \
  --url https://api.arize.com/v2/tasks/{task_id}/runs \
  --header 'Authorization: Bearer <token>'
{
  "task_runs": [
    {
      "id": "VGFza1J1bjo5OTpxUndY",
      "task_id": "T25saW5lVGFzazo0NTpxUndY",
      "status": "completed",
      "run_started_at": "2026-03-07T10:30:01.000Z",
      "run_finished_at": "2026-03-07T10:35:22.000Z",
      "data_start_time": "2026-03-01T00:00:00.000Z",
      "data_end_time": "2026-03-07T00:00:00.000Z",
      "num_successes": 4850,
      "num_errors": 12,
      "num_skipped": 138,
      "created_at": "2026-03-07T10:30:00.000Z",
      "created_by_user_id": "VXNlcjoxOm5OYkM="
    }
  ],
  "pagination": {
    "has_more": false
  }
}

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

​
task_id
string
required

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

Example:

"RW50aXR5OjEyMzQ1"

Query Parameters

​
status
enum<string>

Filter by run status: pending, running, completed, failed, cancelled Status of a task run.

  • pending - The run has been created but not yet started.
  • running - The run is currently in progress.
  • completed - The run finished successfully.
  • failed - The run encountered an error and stopped.
  • cancelled - The run was cancelled before completion.
Available options:
pending,
running,
completed,
failed,
cancelled
​
limit
integer
default:50

Maximum items to return

Required range: 1 <= x <= 100
​
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

Returns a list of task run objects

​
task_runs
object[]
required

A list of task runs

​
pagination
object
required

Pagination metadata for cursor-based navigation