---
title: "Get a Model Lab run"
method: GET
path: "/api/v2/model-lab-api/runs/{run_id}"
tags: ["Model Lab API"]
---

# Get a Model Lab run

`GET /api/v2/model-lab-api/runs/{run_id}`

Get a single Model Lab run by its ID.

## Path parameters

- `run_id` integer, required

## Response `200`

OK

- ModelLabRunResponse — Response containing a single Model Lab run.
  - `data` ModelLabRunData, required — A Model Lab run JSON:API resource object.
    - `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.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `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)