Search building inspections
search_inspectionsRead-onlyIdempotent
Search inspection logs by place, permit, type, result and date. Summaries and future scheduled inspections are excluded by default; upcoming and summaries opt in. Sources report data_through. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_inspections"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name (matches the address city or the issuing jurisdiction) | |
| page | No | Page number, 1-based (default 1) | |
| scope | No | permit (default): inspections of permitted work. existing / occupancy: occupancy inspections of existing buildings that no permit asked for; all. | permit |
| start | No | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) | |
| state | No | 2-letter state code | |
| trade | No | ||
| parcel | No | Parcel / APN / folio (formatting ignored) | |
| result | No | PASS, FAIL, PARTIAL, CANCELLED, SCHEDULED or OTHER | |
| address | No | Street address, partial, case-insensitive | |
| per_page | No | Results per page (default 25, max 25) | |
| upcoming | No | Future-dated (still scheduled) inspections: exclude (the default, except with result=SCHEDULED), include, or only (soonest first). | |
| zip_code | No | 5-digit ZIP | |
| permit_id | No | A permit id from /v1/permits | |
| summaries | No | 'Last inspection' summaries copied from permit records (not inspection logs). Default exclude. | exclude |
| date_after | No | inspection_date on or after (undated inspections never match) | |
| final_only | No | Only final / certificate-of-occupancy inspections | |
| date_before | No | inspection_date on or before | |
| permit_number | No | The permit number, as the city publishes it or as /v1/permits returns it | |
| inspection_type | No | Normalised inspection type, e.g. FRAMING, ROUGH, FINAL | |
| jurisdiction_id | No | A jurisdiction id from /v1/jurisdictions (narrows permit_number) |