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

# All Runs

> List all monitor runs across all monitors, optionally filtered by type.

## Authentication

Requires an API key in the `Authorization` header.

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

## Query parameters

<ParamField query="type" type="string">
  Filter runs to a specific monitor type. Valid values: `email`, `phone`, `domain`, `ip`, `company`, `darkweb`.

  If omitted, returns runs across all monitor types.
</ParamField>

<ParamField query="limit" type="number">
  Number of results to return. Default: `20`. Max: `100`.
</ParamField>

<ParamField query="offset" type="number">
  Number of results to skip for pagination. Default: `0`.
</ParamField>

### Example request

```bash theme={"dark"}
# All runs for phone monitors
curl "https://encrata.com/api/monitoring/runs?type=phone&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

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

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

### Run object

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

<ResponseField name="monitor_id" type="string">
  The monitor this run belongs to.
</ResponseField>

<ResponseField name="monitor_name" type="string">
  The monitor's display name.
</ResponseField>

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

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

<ResponseField name="changes_detected" type="number">
  Number of targets 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 finished.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of run creation.
</ResponseField>

### Example response

```json theme={"dark"}
{
  "runs": [
    {
      "id": "b2c3d4e5-...",
      "monitor_id": "a1b2c3d4-...",
      "monitor_name": "VIP Phone Tracker",
      "status": "success",
      "total_records": 25,
      "changes_detected": 3,
      "credits_used": 25,
      "started_at": "2026-05-10T08:00:00Z",
      "completed_at": "2026-05-10T08:02:15Z",
      "created_at": "2026-05-10T08:00:00Z"
    }
  ],
  "total": 1
}
```