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

# List Monitors

> List all monitors for the authenticated user.

## Authentication

Requires an API key in the `Authorization` header.

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

## Request

No parameters required. Returns all monitors for the authenticated user.

### Example request

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

## Response

Returns an array of monitor objects.

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

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

<ResponseField name="frequency" type="string">
  How often the monitor runs: `monthly` or `quarterly`.
</ResponseField>

<ResponseField name="change_detection" type="string">
  Detection mode: `diff_only` (only report changes) or `full_refresh` (re-enrich all).
</ResponseField>

<ResponseField name="status" type="string">
  Current status: `active`, `paused`, or `failed`.
</ResponseField>

<ResponseField name="tracked_fields" type="string[]">
  Fields being tracked for changes. Empty array means all fields are tracked.
</ResponseField>

<ResponseField name="email_count" type="number">
  Number of emails in this monitor.
</ResponseField>

<ResponseField name="last_run_at" type="string | null">
  ISO 8601 timestamp of the last completed run.
</ResponseField>

<ResponseField name="next_run_at" type="string | null">
  ISO 8601 timestamp of the next scheduled run.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the monitor was created.
</ResponseField>