king-county-permit-status

Added value: +"Give `query` (address / parcel / permit number) OR `contractor` / `license` for a contractor pull-history search; never both."

Added value: +{
+  "description": "Contractor company name (substring) — returns what they have pulled across the MyBuildingPermit cities. Use instead of query.",
+  "type": "string"
+}

Added value: +{
+  "description": "WA L&I contractor license number — same search by license. Use instead of query.",
+  "type": "string"
+}

Previous value: -[
-  "query"
-]New value: +[]

Added value: +{
+  "description": "Contractor searches only: which cities were (and were not) searched",
+  "type": "string"
+}

Previous value: -"Which authority the query was routed to and why. basis: city-limits (geocoded point inside the city's polygon — authoritative), geocoder-city (locator's city, outside King County's polygon layer), address-text (the mailing city in the query), null (none). unincorporated=true means county permits only."New value: +"Which authority the query was routed to and why. basis: city-limits (geocoded point inside the city's polygon — authoritative), geocoder-city (locator's city, outside King County's polygon layer), address-text (the mailing city in the query), parcel-site-address (a parcel query, resolved through the Assessor's site address), null (none). unincorporated=true means county permits only."

Previous value: -[
-  "city-limits",
-  "geocoder-city",
-  "address-text",
-  null
-]New value: +[
+  "city-limits",
+  "geocoder-city",
+  "address-text",
+  "parcel-site-address",
+  null
+]

Previous value: -[
-  "address",
-  "parcel",
-  "permit"
-]New value: +[
+  "address",
+  "parcel",
+  "permit",
+  "contractor"
+]

Previous value: -[
-  "no_feed",
-  "electrical_only",
-  "parcel_resolution_failed",
-  "source_incomplete",
-  "source_blocked"
-]New value: +[
+  "no_feed",
+  "electrical_only",
+  "parcel_resolution_failed",
+  "source_incomplete",
+  "source_blocked",
+  "source_capped"
+]

Previous value: -"Normalized across vendor status vocabularies: false when finaled/closed/expired/withdrawn/etc., null when the source exposes no status"New value: +"Heuristic, census-tested weekly: false when finaled/closed/expired/withdrawn/etc. (or a finaled_date exists), true for issued/pending/review words, null when the source exposes no status. Check is_open_basis before relying on it."

Added value: +{
+  "description": "finaled_date = certain (the record carries a final date); status-vocabulary = regex over the vendor's status word (heuristic); null = no status available",
+  "enum": [
+    "finaled_date",
+    "status-vocabulary",
+    null
+  ],
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Per permit type (building, mechanical_plumbing, electrical, land_use, engineering_row, fire, grading, septic) for the resolved jurisdiction: {system, portal, live, note}. live=true means that system is searched by this tool; otherwise the portal is where to look. Present for address queries and parcel queries that resolved a city.",
+  "type": "object"
+}

Previous value: -"Computed over every permit matching since/types (not just the returned rows): total, matched, returned, truncated, open, closed, status_unknown, by_type, by_status, by_year, years [oldest, newest], latest {permit_number,type,status,date,jurisdiction}. Answer from this; drill into permits only when you need rows."New value: +"Computed over every permit matching since/types (not just the returned rows): total, matched, returned, truncated, open, closed, status_unknown, open_basis_counts {finaled_date, status-vocabulary} (how many open/closed verdicts rest on a fact vs the status-word heuristic), by_type, by_status, by_year, years [oldest, newest], latest {permit_number,type,status,date,jurisdiction}. Answer from this; drill into permits only when you need rows."

Previous value: -[
-  "no_feed",
-  "electrical_only",
-  "parcel_resolution_failed",
-  "source_incomplete"
-]New value: +[
+  "no_feed",
+  "electrical_only",
+  "parcel_resolution_failed",
+  "source_incomplete",
+  "source_blocked"
+]

Added value: +{
+  "default": 50,
+  "description": "Max permits to return (newest first). summary always covers the whole matched set, so start small and raise only if you need the rows.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Only permits applied/issued on or after this date (YYYY-MM-DD).",
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}

Added value: +{
+  "description": "Case-insensitive substrings matched against each permit's type, e.g. ['electrical', 'mechanical'].",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Present when several parcels sit within 40 ft of an interpolated point; the first was used",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "How the parcel was found: the locator's address point; the parcel polygon under an interpolated point; or the nearest parcel within 40 ft (check candidate_parcels)",
+  "enum": [
+    "address-point",
+    "parcel-polygon",
+    "nearby-parcel",
+    null
+  ],
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The limit/since/types that produced this response",
+  "type": "object"
+}

Added value: +"Unique permits found before any since/types filter (= summary.total)"

Previous value: -"Permit records sorted newest applied_date first."New value: +"Up to `limit` permit records, newest first (applied_date, else issued_date)."

Added value: +{
+  "description": "Computed over every permit matching since/types (not just the returned rows): total, matched, returned, truncated, open, closed, status_unknown, by_type, by_status, by_year, years [oldest, newest], latest {permit_number,type,status,date,jurisdiction}. Answer from this; drill into permits only when you need rows.",
+  "type": "object"
+}

Previous value: -"live — every applicable source answered; partial — some source errored or a city portal needs manual follow-up; fallback — nothing searchable, use separate_portal"New value: +"live — every applicable source answered; partial — a source errored or hit its result cap (see errors); fallback — nothing searchable, use next_step. A city needing manual follow-up (next_step) does not by itself lower trust."