API reference
Base URL https://api.isopleth.dev. Machine-readable schema:
openapi.json (OpenAPI 3.1.0). All endpoints need an API key.
Request and response bodies are JSON.
GET/v1/meta/fields
Field catalog, presets and per-source licensing (free)
GET/v1/usage
Plan, limits, balance and recent usage for this key's account (free)
POST/v1/geocode
Geocode a US address (1 lookup when it resolves)
Request body
| name | type | description |
|---|---|---|
address required | string |
POST/v1/fetch
Fields for one location
Request body
| name | type | description |
|---|---|---|
lat | number | WGS84 latitude |
lng | number | WGS84 longitude |
address | string | US street address (geocoded) |
fields | array of | Field names (see /v1/meta/fields). Up to 50 outside a preset. |
preset | string | Named field bundle (see /v1/meta/fields presets) |
extras | boolean | Include per-field timing and cache details |
max_wait_s | number | Upper bound on upstream wait; clamped to the plan cap |
POST/v1/fetch/batch
Same fields for up to N locations (plan limit); results index-aligned
Request body
| name | type | description |
|---|---|---|
locations required | array of Location | |
fields | array of | |
preset | string | |
extras | boolean | |
max_wait_s | number |
Location object
| name | type | description |
|---|---|---|
lat | number | |
lng | number | |
address | string |