API Reference › Property Monitors
Monitor Delivery History
GET /v1/api/property-monitors/{id}/runs/
Cost: Free.
Rate limit: 60 requests per minute per account.
Mode: Sync
Returns the lead lists a monitor has delivered, newest first. Each run is a normal Lead Builder list, poll or download it exactly like an /execute/ result. Every run carries a rows_url (pull structured rows as JSON) and a download_url (CSV) directly, you never have to build those URLs yourself.
Paginated: full history is always reachable. The 500 is a *page-size* limit (the most runs a single response returns), not a cap on how much history you can retrieve. There's no upper bound on page: every delivery a monitor has ever made stays retrievable. per_page defaults to 100 (max 500); increment page to walk older runs, and read total_runs / total_pages to know when you've reached the end. Newest first. Runs in progress show status: "pending" with an empty download_url (their rows_url returns 409 until the run finishes).
Related endpoints: Create a Monitor · List Monitors · Get a Monitor
Fields
id (required): The monitor id.
page: 1-based page number (newest first). Defaults to 1.
per_page: Runs per *page* (response size: not a cap on total history). Defaults to 100, max 500.
Responses
200: Success.
404: Unknown or cross-account monitor
429: Rate limit reached: 60 requests per minute per account.