Search occupancy certificates
search_certificatesRead-onlyIdempotent
Search certificates of occupancy or completion. Defaults exclude renewals; co_date_basis states what each date means. Completion certificates do not establish occupancy, and pending applications are not issued certificates. 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_certificates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lng | No | ||
| city | No | City name (matches the address city or the issuing jurisdiction) | |
| kind | No | 'occupancy' (default), 'completion' (certificates of completion: close-outs of work that creates no occupancy, e.g. roofs, pools), or 'all' | occupancy |
| page | No | Page number, 1-based (default 1) | |
| 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 | |
| parcel | No | Parcel / APN / folio / BBL (formatting ignored) | |
| address | No | Street address, partial, case-insensitive | |
| co_type | No | 'change' = re-issued for an existing building's new owner, use or occupant load; 'revision' = a revised certificate. Neither certifies new units: their dwelling units are in units_existing, so min_units counts newly certified units. | |
| per_page | No | Results per page (default 25, max 25) | |
| renewals | No | Temporary-certificate RENEWALS (NYC re-issues a TCO every 90 days). Default 'exclude': finals and first-time TCOs only. | exclude |
| zip_code | No | 5-digit ZIP | |
| co_number | No | ||
| min_units | No | Newly certified dwelling units on or above (units_existing is not counted) | |
| issued_after | No | CO date on or after (undated certificates never match) | |
| radius_miles | No | Radius in miles around lat/lng (default 1) | |
| issued_before | No | CO date on or before | |
| permit_number | No | The building permit the certificate was issued on | |
| jurisdiction_id | No | A jurisdiction id from /v1/jurisdictions | |
| occupancy_class | No | Building-code occupancy group as published, e.g. R-3, B | |
| certificate_status | No | Default: issued + expired (both were issued). 'pending' = CO applications not yet issued. |