API Reference
Counties
List counties with available parcel data.
GET /counties
Returns US counties with a flag indicating whether each county has a configured parcel source and is ready to query.
Request
curl https://api.tracts.ai/counties \
-H 'x-api-key: YOUR_API_KEY'Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
state | string | No | Filter by two-letter state code (e.g. FL, TX). Case-insensitive. |
limit | integer | No | Maximum number of results to return. Defaults to all configured counties. |
Response
{
"data": [
{
"name": "Hillsborough County",
"state": "FL",
"configured": true
},
{
"name": "Miami-Dade County",
"state": "FL",
"configured": true
},
{
"name": "Orange County",
"state": "FL",
"configured": false
}
],
"total": 3
}Response fields
| Field | Type | Description |
|---|---|---|
data | array | List of county objects |
data[].name | string | County name without the state suffix |
data[].state | string | Two-letter state code |
data[].configured | boolean | true if parcel data is available for this county. Counties with configured: false are listed for visibility but will return an error if queried for parcels. |
total | integer | Total number of counties in the response |
Filtering by state
curl 'https://api.tracts.ai/counties?state=FL' \
-H 'x-api-key: YOUR_API_KEY'Error responses
| Status | Code | Meaning |
|---|---|---|
400 | invalid_limit | limit is not a positive integer |
401 | missing_key | No API key provided |
403 | invalid_key | Key is invalid, expired, or revoked |
429 | rate_limit_exceeded | Hourly rate limit exceeded |
429 | monthly_quota_exceeded | Monthly plan quota exceeded |