---
title: "Get data observability monitor run status"
method: GET
path: "/api/v2/data-observability/monitors/runs/{run_id}/status"
tags: ["Data Observability"]
---

# Get data observability monitor run status

`GET /api/v2/data-observability/monitors/runs/{run_id}/status`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/data-observability/monitors/runs/{run_id}/status`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `data_observability_monitors_write`, `monitors_write`

Retrieves the current status of a data observability monitor run. Poll this endpoint after triggering a run to determine when evaluation is complete.

## Path parameters

- `run_id` string, required

## Response `200`

OK

- GetDataObservabilityMonitorRunStatusResponse: The response for getting the status of a data observability monitor run.
  - `data` GetDataObservabilityMonitorRunStatusResponseData, required: The data object for a data observability monitor run status response.
    - `attributes` GetDataObservabilityMonitorRunStatusResponseAttributes, required: The attributes of a data observability monitor run status response.
      - `error_message` string: Error message describing why the monitor run failed. Only present when status is error.
      - `status` 'pending' | 'ok' | 'warn' | 'alert' | 'error', required: The status of a data observability monitor run.
    - `id` string, required: The unique identifier of the monitor run.
    - `type` 'monitor_run', required: The JSON:API resource type for a data observability monitor run.

## Other responses

- `404`: Not Found
- `429`: Too many requests

---

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