Analyze Boston: building permits, zoning appeals and violations (data.boston.gov) · Search permits
data-boston-gov/building-permits/search_permitsSearch property, job and marketplace listings with Analyze Boston: building permits, zoning appeals and violations (data.boston.gov) · Search permits from Alexandria through one Spiral API key. Use for permits at a Boston address or parcel, a contractor's permits, or new permits since a date: pass issued_since (the last day you checked); the dataset has no application date or row update time, and ISD reloads it daily. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
zip | text | — | 5-digit ZIP code (02127). Pattern: ^[0-9]{5}$. |
sort | one of issued_desc, valuation_desc | issued_desc | issued_desc: newest issued first; valuation_desc: largest declared valuation first. |
limit | number 1 to 100 | 25 | Rows per page. |
cursor | text | — | next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. |
status | text | — | Case-insensitive substring of the status: open, closed, issued, stop work. |
address | text | — | Street line, case-insensitive substring (50 Cromwell Road, 840 Columbus Ave). Text after a comma is ignored; a trailing Street, Avenue, Road, Boulevard, Place and similar becomes ISD's abbreviation (ST, AV, RD, BL, PL). Ranges are written 140-148 Brookline AV, so a number inside a range does not match. |
parcel_id | text | — | Boston parcel id (PID), as in records' parcel_id or the Assessing Department's data (0504219000); exact. Pattern: ^[0-9]{9,10}$. |
contractor | text | — | Case-insensitive substring of the applicant name (Sunrun, Mellett). |
permit_type | text | — | Case-insensitive substring over permit type, work type code, work subtype and occupancy type: short form, electrical, solar, roof, demolition, certificate of occupancy, multi. erect matches every permit with work type ERECT (new building permits, their foundation permits and certificates of occupancy); erect/new matches only the Erect/New Construction permit type. |
issued_since | text | — | Only permits issued on or after this day, YYYY-MM-DD. Use the last day you checked to poll for new permits. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
issued_until | text | — | Only permits issued on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
neighborhood | text | — | Case-insensitive substring of the neighborhood or mailing city as published (Dorchester, East Boston, Jamaica Plain); central neighborhoods are mostly written Boston. |
min_valuation | number 0 to … | — | Only permits whose declared valuation is at least this many USD. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "data-boston-gov/building-permits/search_permits",
"input": {
"zip": "<zip>"
}
}'Frequently asked questions
How much does Analyze Boston: building permits, zoning appeals and violations (data.boston.gov) · Search permits cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Analyze Boston: building permits, zoning appeals and violations (data.boston.gov) · Search permits through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "data-boston-gov/building-permits/search_permits"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use Analyze Boston: building permits, zoning appeals and violations (data.boston.gov) · Search permits?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use Analyze Boston: building permits, zoning appeals and violations (data.boston.gov) · Search permits?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.