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

## Request

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

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.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)