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

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

​
Path parameters

​
id
string
required
The monitor’s unique identifier (UUID).

​
Example request

curl https://encrata.com/api/monitors/a1b2c3d4-.../runs \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
runs
object[]
Array of run objects.
​
total
number
Total number of runs.

​
Run object

​
id
string
Unique run identifier (UUID).
​
status
string
Run status: pending, running, success, or failed.
​
total_records
number
Number of emails processed.
​
changes_detected
number
Number of emails 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 completed.