Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaListingsAvailable now

San José Open Data: building and planning permits (data.sanjoseca.gov) · Search permits

data-sanjoseca-gov/building-permits/search_permits

Search property, job and marketplace listings with San José Open Data: building and planning permits (data.sanjoseca.gov) · Search permits from Alexandria through one Spiral API key. Use for permits at a San José address or parcel, a contractor's permits, large or new-construction projects, or new permits since a day: pass status issued_last_30_days with issued_since set to the last day you checked (the lists are reloaded daily and carry no row update time). 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

FieldKindDefaultDescription
ziptext—

5-digit ZIP code (95131). Pattern: ^[0-9]{5}$.

sortone of
issued_desc, valuation_desc
issued_desc

issued_desc: newest issued first; valuation_desc: largest declared valuation first.

limitnumber
1 to 100
25

Rows per page.

cursortext—

next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$.

statusone of
any, active, under_inspection, expired, issued_last_30_days
any

Which published list to read. any (default): Active, Expired and permits issued in the last 30 days, each permit once, in one request. active: issued and not finaled or expired (includes under inspection); under_inspection: active permits with inspections under way; expired; issued_last_30_days: every permit issued in the last 30 days whatever its state, the list to poll for new permits. Finaled permits older than 30 days are not published.

addresstext—

Street line (988 Rock Avenue, 1123 Coleman Ave). Text after a comma is ignored and a trailing Avenue, Street, Drive, Court, Way, Boulevard, Circle, Expressway and similar becomes the city's abbreviation (AV, ST, DR, CT, WY, BL, CL, EX). A line starting with a house number matches from the start of the address, so 988 Rock AV does not match 1988 Rock AV; directional prefixes are part of the line (1024 S De Anza Blvd).

parcel_idtext—

Santa Clara County APN, 23046055 or 230-46-055; matches any parcel a permit lists. Pattern: ^[0-9]{3}-?[0-9]{2}-?[0-9]{3}$.

contractortext—

Case-insensitive substring of the contractor or applicant as published, company or contact (Sunrun, Devcon, Swenson).

descriptiontext—

Case-insensitive substring of the permit title (FOLDERNAME): stadium, pool, Microsoft, Block A.

permit_typetext—

Case-insensitive substring over folder type, occupancy subtype and work type: New Construction, Solar, ReRoof, Tenant Improvement, Data Center, ADU, Single-Family, Demolition.

issued_sincetext—

Only permits issued on or after this day, YYYY-MM-DD. To poll for new permits, pass the last day you checked. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$.

issued_untiltext—

Only permits issued on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$.

min_valuationnumber
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-sanjoseca-gov/building-permits/search_permits",
    "input": {
      "zip": "<zip>"
    }
  }'

Frequently asked questions

How much does San José Open Data: building and planning permits (data.sanjoseca.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 San José Open Data: building and planning permits (data.sanjoseca.gov) · Search permits through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "data-sanjoseca-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 San José Open Data: building and planning permits (data.sanjoseca.gov) · Search permits?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use San José Open Data: building and planning permits (data.sanjoseca.gov) · Search permits?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.