Documentation menu
Docs / Guides / Monitor new records

Monitor new records

Poll for records added since your last check and act on them automatically.

To act on new records as they appear, poll BuildData on a schedule and keep the IDs you have already seen. Sort by newest and stop once you hit a known record.

import requests

URL = "https://api.builddata.ca/permit"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}

seen = set()  # persist this between runs
r = requests.get(URL, headers=HEADERS, params={"limit": 100}).json()
for record in r.get("results", []):
    rid = record.get("record_id")
    if rid in seen:
        continue
    seen.add(rid)
    notify(record)  # email, Slack, CRM, ...

Run it on a cron (hourly or daily) and route new records to email, Slack, or your CRM.

This loop needs a paid plan. The free tier runs 30 days behind, so a poller on a free key will keep finding the same records it saw yesterday and nothing newer.

Ready to build?Create a free key and start calling BuildData in minutes. No card required.
Get your API key →