City of San Antonio Open Data: building permits (data.sanantonio.gov) · Search permits
data-sanantonio-gov/building-permits/search_permitsSearch property, job and marketplace listings with City of San Antonio Open Data: building permits (data.sanantonio.gov) · Search permits from Alexandria through one Spiral API key. Use for permits at a San Antonio address or ZIP, one contractor's or builder's permits, large projects, or new permits since a date: pass issued_since (the last day you checked); the dataset has no row update time. Then get_permit for every published column, or contractor_activity to rank contacts. 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 (78215). Pattern: ^[0-9]{5}$. |
sort | one of issued_desc, applied_desc, valuation_desc | issued_desc | issued_desc: newest issued first; applied_desc: newest submitted first; valuation_desc: largest declared valuation first. |
limit | number 1 to 100 | 25 | Permits per page. |
cursor | text | — | next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. |
address | text | — | Street line, case-insensitive substring (717 N Alamo St, 315 Tahoe Avenue). Text after a comma is ignored; North/South/East/West after the house number and a trailing Street, Avenue, Drive, Road, Boulevard, Lane and similar become the city's abbreviations (N, ST, AVE, DR, RD, BLVD, LN). Also matches the project name of permits published without an address. |
contractor | text | — | Case-insensitive substring of the primary contact (Lennar, Will Fix It, Sunrun). |
permit_type | text | — | Case-insensitive substring of any of the permit's types or of its work type: new building, res new building, comm remodel, roof, solar, demolition, electrical, sign, tree. A combination permit matches through any of its trade permits. |
issued_since | text | — | Only permits issued on or after this day, YYYY-MM-DD (data starts 2020-07-20). Pass 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}$. |
applied_since | text | — | Only permits first submitted on or after this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
applied_until | text | — | Only permits first submitted 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 (excludes permits without one). |
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-sanantonio-gov/building-permits/search_permits",
"input": {
"zip": "<zip>"
}
}'Frequently asked questions
How much does City of San Antonio Open Data: building permits (data.sanantonio.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 City of San Antonio Open Data: building permits (data.sanantonio.gov) · Search permits through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "data-sanantonio-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 City of San Antonio Open Data: building permits (data.sanantonio.gov) · Search permits?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use City of San Antonio Open Data: building permits (data.sanantonio.gov) · Search permits?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.