Skip to main content
GET
/
api
/
v1
/
monitors
/
{id}
/
runs
List Monitor Runs
curl --request GET \
  --url https://app.datafold.com/api/v1/monitors/{id}/runs \
  --header 'Authorization: <api-key>'
{
  "count": 123,
  "page": 123,
  "page_size": 123,
  "runs": [
    {
      "monitor_id": 123,
      "run_id": 123,
      "diff_id": 123,
      "started_at": "2023-11-07T05:31:56Z",
      "state": "ok"
    }
  ],
  "total_pages": 123
}

Authorizations

​
Authorization
string
header
required

Use the 'Authorization' header with the format 'Key '

Path Parameters

​
id
integer
required

The unique identifier of the monitor.

Query Parameters

​
page
integer
default:1

The page number to retrieve.

​
page_size
integer
default:10

The number of items to retrieve per page.

​
start_time
string<date-time> | null

Include runs with a timestamp >= this value.

​
end_time
string<date-time> | null

Include runs with a timestamp <= this value.

Response

Successful Response

​
count
integer
required

Total number of monitor runs.

​
page
integer
required

Current page number in the paginated result.

​
page_size
integer
required

Number of runs per page.

​
runs
ApiPublicMonitorRunOut · object[]
required

List of monitor runs.

​
total_pages
integer
required

Total number of pages available.