Permit Signal Leads
Fetch permit-scoped lead rows for a geo_id
geo_id.
It returns the current page of leads, trust fields (event_date_used, signal_basis, confidence, reason_codes), freshness metadata, and the cursor for the next page.
Use include_stale=true if you need rows older than the default freshness window.
Supported permit-pack keys are documented in Signals Catalog.
See also Permit Signal Stats.
Required input
geo_id(query, required, non-property geo)
Optional input
signal_keys(CSV list)from_date,to_date(YYYY-MM-DD)min_confidence(0..1)max_freshness_days(1..3650)include_stale(true|false)sort(event_date_descorconfidence_desc)group_by(none,city,zip)limit(1..100)cursor(opaque pagination token)
Example request
Response shape
geo_id,geo_type,scope=permitsignal_keys[]max_freshness_dayscountnext_cursorleads[](orgroups[]when grouped)
Authorizations
Query Parameters
Location identity token for a non-property geo scope.
"geo_county_6973f63e37a900040c0d"
Optional CSV list of customer-facing permit signal keys. Allowed values: site_prep_issued_nowcast, new_construction_issued_nowcast, framing_nowcast_early, framing_window_late, rough_in_nowcast_early, rough_in_window_late.
"site_prep_issued_nowcast,new_construction_issued_nowcast"
Optional lower bound in YYYY-MM-DD format.
Optional upper bound in YYYY-MM-DD format.
Optional minimum confidence between 0 and 1.
0 <= x <= 1Optional freshness window in days, between 1 and 3650. Defaults to 60 when include_stale is false.
1 <= x <= 3650When true, disables the default freshness filter.
Cursor sort order for the returned page.
event_date_desc, confidence_desc Optional grouping for the returned page.
none, city, zip Maximum rows to return.
1 <= x <= 100Opaque cursor from the previous page.
Response
Permit-scoped lead rows and pagination metadata.
jurisdiction, city, zip, county, state, null permit 1 <= x <= 3650x >= 0none, city, zip 
