---
title: "List Model Lab runs"
method: GET
path: "/api/v2/model-lab-api/runs"
tags: ["Model Lab API"]
---

# List Model Lab runs

`GET /api/v2/model-lab-api/runs`

List all Model Lab runs for the current organization.

## Query parameters

- `filter[id]` string
- `filter` string
- `filter[owner_id]` string
- `filter[status]` 'pending' | 'running' | 'completed' | 'failed' | 'killed' | 'unresponsive' | 'paused' — The status of a Model Lab run.
- `filter[project_id]` integer
- `filter[tags]` string
- `filter[params]` string
- `filter[parent_run_id]` string
- `pinned_first` boolean
- `include_pinned` boolean
- `include_descendant_matches` boolean
- `sort` string
- `page[size]` integer
- `page[number]` integer

## Response `200`

OK

- ModelLabRunsResponse — Response containing a list of Model Lab runs with pagination metadata.
  - `data` ModelLabRunData[], required — The list of runs.
    - `attributes` ModelLabRunAttributes, required — Attributes of a Model Lab run.
      - `completed_at` string, date-time, nullable — The date and time the run completed.
      - `created_at` string, date-time, required — The date and time the run was created.
      - `deleted_at` string, date-time, nullable — The date and time the run was soft-deleted.
      - `descendant_match` boolean, required — Whether a descendant run matched the applied filters.
      - `description` string, required — A description of the run.
      - `duration` number, double, nullable — The duration of the run in seconds.
      - `external_url` string, nullable — An optional external URL associated with the run.
      - `has_children` boolean, required — Whether the run has child runs.
      - `is_pinned` boolean, required — Whether the run is pinned by the current user.
      - `metric_summaries` ModelLabMetricSummary[], required — Summary statistics for metrics recorded during the run.
        - `count` integer, required — The total number of recorded values.
        - `first_step` integer, nullable — The first step at which the metric was recorded.
        - `key` string, required — The metric name.
        - `last_step` integer, nullable — The last step at which the metric was recorded.
        - `latest` number, double, nullable — The most recently recorded value.
        - `max` number, double, nullable — The maximum recorded value.
        - `mean` number, double, nullable — The mean of recorded values.
        - `min` number, double, nullable — The minimum recorded value.
        - `stddev` number, double, nullable — The standard deviation of recorded values.
      - `mlflow_artifact_location` string, required — The MLflow artifact storage location for this run.
      - `name` string, required — The name of the run.
      - `owner_id` string, nullable — The UUID of the run owner.
      - `params` ModelLabRunParam[], nullable, required — The list of parameters used for the run.
        - `key` string, required — The parameter key.
        - `value` string, required — The parameter value.
      - `project_id` integer, required — The ID of the project this run belongs to.
      - `started_at` string, date-time, required — The date and time the run started.
      - `status` 'pending' | 'running' | 'completed' | 'failed' | 'killed' | 'unresponsive' | 'paused', required — The status of a Model Lab run.
      - `tags` ModelLabTag[], required — The list of tags associated with the run.
        - `key` string, required — The tag key.
        - `value` string, required — The tag value.
      - `updated_at` string, date-time, required — The date and time the run was last updated.
    - `id` string, required — The unique identifier of the run.
    - `type` 'runs', required — The JSON:API type for a Model Lab run resource.
  - `links` ModelLabPaginationLinks — Pagination links for navigating list responses.
    - `first` string — Link to the first page.
    - `last` string — Link to the last page.
    - `next` string, nullable — Link to the next page.
    - `prev` string, nullable — Link to the previous page.
    - `self` string — Link to the current page.
  - `meta` ModelLabPageMeta, required — Pagination metadata for a list response.
    - `page` ModelLabPageMetaPage, required — Pagination details for a list response.
      - `first_number` integer — The first page number.
      - `last_number` integer — The last page number.
      - `next_number` integer, nullable — The next page number.
      - `number` integer, required — The current page number.
      - `prev_number` integer, nullable — The previous page number.
      - `size` integer, required — The number of items per page.
      - `total` integer, required — The total number of items.
      - `type` string — The pagination type.

## Other responses

- `400` — Bad Request
- `429` — Too many requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)