All Runs

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

GET /api/agent/monitoring/runs

All Runs

cURL

curl --request GET \
  --url https://encrata.com/api/agent/monitoring/runs \
  --header 'Authorization: Bearer <token>'

200

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

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
}