Skip to main content

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

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

TypeTargetsTracks
emailEmail addressesJob changes, company, location, social profiles
phonePhone numbersCarrier, location, line type
domainDomain namesRegistrar, expiry, DNS records
ipIP addressesGeolocation, ISP, threat score
companyCompany namesIndustry, size, location, leadership
darkwebSearch queriesBreach mentions, severity, sources

​
How it works

1

Create a monitor

Give it a name, choose the type, add your targets (emails, phones, domains, etc.), and select a frequency.
2

Choose detection mode

  • 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.
3

Encrata runs on schedule

On each scheduled run, Encrata re-enriches every target in the monitor and compares results to the previous snapshot.
4

Review changes

View run results in the dashboard or receive webhook notifications when changes are detected.

​
Use cases

Sales Intelligence

Track when prospects change companies or get promoted — perfect timing for outreach.

Domain Monitoring

Watch for DNS changes, expiring domains, or registrar transfers across your portfolio.

Threat Intelligence

Monitor IPs for threat score changes and dark web for credential leaks.

CRM Enrichment

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

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: 
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 for all options.

​
Frequency options

FrequencySchedule
weeklyRuns once every 7 days
biweeklyRuns once every 14 days
monthlyRuns once every 30 days from creation
quarterlyRuns 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

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

ActionDashboardAPI
Pause / ResumeToggle from detail pagePATCH /api/monitors/:id with status
EditClick Edit on detail pagePATCH /api/monitors/:id
DeleteClick DeleteDELETE /api/monitors/:id
Run nowClick “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.