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.

​
Overview

List endpoints that return multiple items support pagination using limit and offset query parameters.

​
Parameters

ParameterTypeDefaultMaxDescription
limitinteger20100Number of items to return
offsetinteger0—Number of items to skip
Contact list endpoints currently return all items without pagination.

​
Response format

Paginated responses include a total field alongside the data array: 
{
  "runs": [
    {
      "id": "run_abc123",
      "monitor_id": "mon_xyz",
      "status": "completed",
      "created_at": "2026-05-18T10:00:00Z"
    }
  ],
  "total": 47
}

​
Paginated endpoints

EndpointArray fieldDefault limitMax limit
GET /api/agent/monitors/{id}/runsruns20100
GET /api/agent/monitors/{id}/runs/{runId}/resultsresults20100
GET /api/agent/monitoring/runsruns20100
GET /api/agent/monitoring/resultsresults20100

​
Example

Fetch the second page of monitor runs (items 21–40): 
curl "https://encrata.com/api/agent/monitors/mon_xyz/runs?limit=20&offset=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Iterating through all pages

def get_all_runs(monitor_id, api_key):
    runs = []
    offset = 0
    limit = 100

    while True:
        resp = requests.get(
            f"https://encrata.com/api/agent/monitors/{monitor_id}/runs",
            headers={"Authorization": f"Bearer {api_key}"},
            params={"limit": limit, "offset": offset},
        )
        data = resp.json()
        runs.extend(data["runs"])

        if offset + limit >= data["total"]:
            break
        offset += limit

    return runs

​
Filtering

Some endpoints support additional query filters alongside pagination:
ParameterEndpointsDescription
type/monitoring/runs, /monitoring/resultsFilter by monitor type (email, domain, ip, etc.)
changes_only/runs/{id}/results, /monitoring/resultsOnly return items with detected changes