> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitor Runs

> List all runs for a monitor with stats.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Path parameters

<ParamField path="id" type="string" required>
  The monitor's unique identifier (UUID).
</ParamField>

### Example request

```bash theme={"dark"}
curl https://encrata.com/api/monitors/a1b2c3d4-.../runs \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

<ResponseField name="runs" type="object[]">
  Array of run objects.
</ResponseField>

<ResponseField name="total" type="number">
  Total number of runs.
</ResponseField>

### Run object

<ResponseField name="id" type="string">
  Unique run identifier (UUID).
</ResponseField>

<ResponseField name="status" type="string">
  Run status: `pending`, `running`, `success`, or `failed`.
</ResponseField>

<ResponseField name="total_records" type="number">
  Number of emails processed.
</ResponseField>

<ResponseField name="changes_detected" type="number">
  Number of emails with field changes since the previous run.
</ResponseField>

<ResponseField name="credits_used" type="number">
  Credits consumed by this run.
</ResponseField>

<ResponseField name="started_at" type="string | null">
  ISO 8601 timestamp when the run started.
</ResponseField>

<ResponseField name="completed_at" type="string | null">
  ISO 8601 timestamp when the run completed.
</ResponseField>