Skip to main content
GET
/
api
/
monitoring
/
runs
All Runs
curl --request GET \
  --url https://encrata.com/api/monitoring/runs \
  --header 'Authorization: Bearer <token>'
{
  "runs": [
    {}
  ],
  "total": 123,
  "id": "<string>",
  "monitor_id": "<string>",
  "monitor_name": "<string>",
  "status": "<string>",
  "total_records": 123,
  "changes_detected": 123,
  "credits_used": 123,
  "started_at": {},
  "completed_at": {},
  "created_at": "<string>"
}

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.

​
Authentication

Requires an API key in the Authorization header. 
Authorization: Bearer YOUR_API_KEY

​
Query parameters

​
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.
​
limit
number
Number of results to return. Default: 20. Max: 100.
​
offset
number
Number of results to skip for pagination. Default: 0.

​
Example request

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

​
Response

​
runs
object[]
Array of run objects with monitor name included.
​
total
number
Total number of matching runs.

​
Run object

​
id
string
Unique run identifier (UUID).
​
monitor_id
string
The monitor this run belongs to.
​
monitor_name
string
The monitor’s display name.
​
status
string
Run status: pending, running, success, or failed.
​
total_records
number
Number of targets processed.
​
changes_detected
number
Number of targets with field changes since the previous run.
​
credits_used
number
Credits consumed by this run.
​
started_at
string | null
ISO 8601 timestamp when the run started.
​
completed_at
string | null
ISO 8601 timestamp when the run finished.
​
created_at
string
ISO 8601 timestamp of run creation.

​
Example response

{
  "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
}