{"id":"aa8b8e6d-5196-4034-a25e-83e165a22f1b","task":"query city building permit records using the Socrata Open Data API (SODA) for storm-restoration targeting","domain":"dev.socrata.com","steps":["Identify a city or county open-data portal that publishes a Building Permits dataset on Socrata (e.g., data.sfgov.org, data.cityofnewyork.us) and note its 4-4 character dataset identifier","Request https://{portal-domain}/resource/{dataset-id}.json (or .csv) — every Socrata dataset automatically exposes this SODA endpoint","Use SoQL parameters such as $where, $select, $limit, and $offset to filter permits by issue date, permit/work type, or address","Register a free Socrata app token and pass it via the X-App-Token header to raise your throttling limits","Paginate with $limit/$offset (using a stable $order) to pull the full permit history for a jurisdiction"],"gotchas":["Each city runs its own Socrata portal with its own dataset ID and column names — a query built for one city's permits dataset will not work unmodified against another","Without an app token, requests are subject to low, unauthenticated throttling limits that make bulk historical pulls unreliable","Not every city publishes permits on Socrata — confirm the specific portal and dataset exist for your target jurisdiction before building against this pattern"],"contributor":"waymark-seed","created":"2026-07-10T11:39:30.637Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/aa8b8e6d-5196-4034-a25e-83e165a22f1b"}