> ## 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.
# Monitors
> Automatically track changes across emails, phones, domains, IPs, companies, and dark web queries.
# Monitors
Monitors let you schedule recurring enrichment on a set of targets and get notified when something changes — like a job title, company, DNS record, or dark web exposure.
## Supported monitor types
| Type | Targets | Tracks |
| --------- | --------------- | ----------------------------------------------- |
| `email` | Email addresses | Job changes, company, location, social profiles |
| `phone` | Phone numbers | Carrier, location, line type |
| `domain` | Domain names | Registrar, expiry, DNS records |
| `ip` | IP addresses | Geolocation, ISP, threat score |
| `company` | Company names | Industry, size, location, leadership |
| `darkweb` | Search queries | Breach mentions, severity, sources |
## How it works
Give it a name, choose the type, add your targets (emails, phones, domains, etc.), and select a frequency.
* **Changes only** (`diff_only`) — only flags fields that changed since the last run.
* **Full refresh** (`full_refresh`) — re-enriches all fields every run regardless of changes.
On each scheduled run, Encrata re-enriches every target in the monitor and compares results to the previous snapshot.
View run results in the dashboard or receive webhook notifications when changes are detected.
## Use cases
Track when prospects change companies or get promoted — perfect timing for outreach.
Watch for DNS changes, expiring domains, or registrar transfers across your portfolio.
Monitor IPs for threat score changes and dark web for credential leaks.
Keep your CRM data fresh by detecting stale records automatically.
## Creating a monitor
### From the dashboard
Each lookup type has its own **Monitors** section in the sidebar:
1. Navigate to the lookup type (e.g., Phone Lookup → Monitors).
2. Click **Create monitor**.
3. Enter a name, add your targets, select frequency and detection mode.
4. Click **Create** — your first run will be scheduled automatically.
### Via the API
```bash theme={"dark"}
curl -X POST https://encrata.com/api/monitors \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"name": "Domain Portfolio Watch",
"monitor_type": "domain",
"targets": ["example.com", "mysite.io"],
"frequency": "monthly",
"change_detection": "diff_only"
}'
```
For email monitors, use `emails` instead of `targets`:
```bash theme={"dark"}
curl -X POST https://encrata.com/api/monitors \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"name": "Sales Team Tracker",
"monitor_type": "email",
"emails": ["ceo@example.com", "cto@example.com"],
"frequency": "monthly",
"change_detection": "diff_only"
}'
```
See the full [API Reference](/api-reference/endpoint/create-monitor) for all options.
## Frequency options
| Frequency | Schedule |
| ----------- | ------------------------------------- |
| `weekly` | Runs once every 7 days |
| `biweekly` | Runs once every 14 days |
| `monthly` | Runs once every 30 days from creation |
| `quarterly` | Runs once every 90 days from creation |
## Change detection modes
### Changes only (`diff_only`)
Compares the current enrichment result against the previous run. Only flags fields that differ. This is the default and most efficient mode.
### Full refresh (`full_refresh`)
Re-enriches all fields every run and returns the complete profile regardless of whether anything changed. Useful when you need a full snapshot each time.
## Cross-monitor views
Each lookup type provides aggregate views across all its monitors:
* **Runs** — View all runs across all monitors of that type with status, duration, and change counts.
* **Results** — Browse all enrichment results, filterable to changes only.
* **Targets** — See every target being tracked across all monitors of that type.
* **Lists** — Create and manage reusable target lists that can be shared across monitors.
Access these from the sidebar under each lookup type's **Monitoring** section.
### Via the API
```bash theme={"dark"}
# All runs for domain monitors
curl "https://encrata.com/api/monitoring/runs?type=domain" \
-H "Authorization: Bearer YOUR_API_KEY"
# All results with changes for phone monitors
curl "https://encrata.com/api/monitoring/results?type=phone&changes_only=true" \
-H "Authorization: Bearer YOUR_API_KEY"
# All tracked targets for IP monitors
curl "https://encrata.com/api/monitoring/targets?type=ip" \
-H "Authorization: Bearer YOUR_API_KEY"
```
## Contact lists
Lists let you save a reusable set of targets (emails, phones, domains, etc.) that can be referenced when creating monitors.
```bash theme={"dark"}
# Create a phone number list
curl -X POST https://encrata.com/api/lists \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"name": "VIP Contacts",
"type": "phone",
"targets": ["+14155551234", "+442071234567"]
}'
# List all domain lists
curl "https://encrata.com/api/lists?type=domain" \
-H "Authorization: Bearer YOUR_API_KEY"
```
## Tracked fields
By default, monitors track all available fields. You can optionally specify which fields to watch:
* `company` — Company name changes
* `job_role` — Job title or role changes
* `industry` — Industry classification changes
* `bio` — Bio or summary updates
* `location` — Location changes
* `social` — Social profile URL changes
## Viewing run results
Each monitor run produces a result set you can inspect:
1. Click on a monitor to open its detail page.
2. Under **Runs**, click any completed run to see which targets had changes.
3. For each changed target, you can view a side-by-side diff of old vs. new values.
## Webhooks
You can receive real-time notifications when a monitor run completes and changes are detected. Set up a [webhook](/webhooks) with the `monitor.run.completed` event to get notified automatically.
## Limits
* Each monitor can track up to **1,000 targets**.
* You can have up to **50 active monitors** per account.
* Each run consumes credits based on the number of targets enriched.
## Managing monitors
| Action | Dashboard | API |
| -------------- | ------------------------- | --------------------------------------- |
| Pause / Resume | Toggle from detail page | `PATCH /api/monitors/:id` with `status` |
| Edit | Click Edit on detail page | `PATCH /api/monitors/:id` |
| Delete | Click Delete | `DELETE /api/monitors/:id` |
| Run now | Click "Run now" | `POST /api/monitors/:id/run` |
## FAQ
Any field value that differs from the previous run's snapshot. For example, if a domain's registrar changed from GoDaddy to Cloudflare, that's a change.
No. Paused monitors skip their scheduled runs and don't consume any credits until resumed.
Yes. Edit the monitor and add new targets. They'll be included in the next scheduled run.
Emails, phone numbers, domains, IP addresses, company names, and dark web search queries.
Yes. Create a contact list and reference it when creating monitors. The list can be shared across any number of monitors of the same type.