# San José Open Data: building and planning permits (data.sanjoseca.gov) · 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.

- Provider: Alexandria
- Category: Listings
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `data-sanjoseca-gov/building-permits/search_permits`
- Page: https://spiral.ai/tools/alexandria/data-sanjoseca-gov/building-permits/search_permits

## Pricing

$0.00873 per call.

## Limits

- 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 | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `zip` | text |  | — | 5-digit ZIP code (95131). 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` | one 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. |
| `address` | text |  | — | 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_id` | text |  | — | 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}$. |
| `contractor` | text |  | — | Case-insensitive substring of the contractor or applicant as published, company or contact (Sunrun, Devcon, Swenson). |
| `description` | text |  | — | Case-insensitive substring of the permit title (FOLDERNAME): stadium, pool, Microsoft, Block A. |
| `permit_type` | text |  | — | Case-insensitive substring over folder type, occupancy subtype and work type: New Construction, Solar, ReRoof, Tenant Improvement, Data Center, ADU, Single-Family, Demolition. |
| `issued_since` | text |  | — | 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_until` | text |  | — | Only permits issued on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `min_valuation` | number | 0 to … | — | Only permits whose declared valuation is at least this many USD. |

## Example

```bash
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>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=data-sanjoseca-gov%2Fbuilding-permits%2Fsearch_permits

## Common questions

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

**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.

