Compliance lists › Alerts
For firms and property managersCompliance alerts: the buildings that changed, every day or week
Pick a list, your ZIPs and what you care about. Each morning, or each Monday, you get the buildings that were added, taken off the agency's list, or changed, each linked to its agency record. By email, by a signed webhook to your own system, or both.
Your alerts
Sign in to see and change your alerts. Sign in by email
What's in every alert
- What changed, building by building: the address, ZIP, what moved (for example "due 2026-08-09 → 2027-02-09") and a link to the agency record.
- Buildings that owe more than one thing come first, marked with the other lists they're on.
- Your tracked buildings: follow up to 1,000 items one by one, such as your jobs or your portfolio. Each closes on its own when the agency's data no longer lists it, and reopens if it comes back. You're told either way.
- New Water Board actions on stormwater facilities in your ZIPs.
- How fresh the data is. If the agency's source hasn't refreshed, or a pull looked wrong and was held, the alert says so. A quiet week still sends a weekly alert saying nothing changed.
- A spreadsheet link with every row, good for 30 days.
What it costs
Setting up alerts is free. In each delivery the first 10 rows are free, and rows past that cost what list rows cost. The first 10 rows of any list are free. After that it's $1 for each 100 rows, or $99 for a whole list as a spreadsheet (CSV). Tracked-item updates are always free. If your credits run out, the alert still comes with the counts and the first 10 rows, says how many more there are, and charges nothing.
Set one up
You need an API key with credits: get one here. Then:
curl -X POST "https://api.sos.city/v1/compliance/watches" \
-H "Authorization: Bearer sos_live_…" -H "Content-Type: application/json" \
-d '{"list":"sb721-cited","name":"SB 721 in my ZIPs","zips":["90019","90036"],
"cadence":"weekly","webhook_url":"https://you.example.com/sos","track":["5071014042"]}'
Lists: sb721-cited, ebewe-not-complied, code-cases-open, soft-story-open, ndc-concrete, stormwater-facilities. Filters: zips, status, type, stacked, kinds (added, removed, changed). See them with GET /v1/compliance/watches and stop one with DELETE /v1/compliance/watches/{id}. AI assistants can do the same through MCP with watch_compliance and list_compliance_watches (connect).
Checking a webhook came from us
Each webhook is a JSON POST with the header X-SOS-Signature: t=<time>,v1=<signature>. The signature is HMAC-SHA256 of t + "." + body with the webhook_secret you were given when you made the alert. Check it and the time before you trust the body.
What "off the list" means
It means the agency's own data no longer lists the building. Usually that's because the work was filed or the case closed, but it isn't proof. Every alert links the agency record so you can check. These lists are buildings and facilities, read from public records. They hold no people: no names of individuals, phones or emails. They may not be used for tenant, employment, credit or insurance screening, or to locate or profile anyone.