---
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`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/model-lab-api/runs`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)