List subdivisions
GET /v1/boundaries/{id}/childrenFreeNo key neededRead-only
The direct subdivisions of a boundary: a country's states, a state's counties, a city's districts. Without admin_level it picks the next level that exists. Free and public. Use it to build drill-down pickers or to cover a region with its parts.
MCP tool list_children · CLI geocode list-children · RPC POST /v1/ops/list_children
Input
| Field | Type | Description |
|---|---|---|
idpath, required | string | Boundary id: r<OSM relation id> (e.g. r62422 for Berlin) or w<way id>. Also accepts R62422, relation/62422, -62422, an openstreetmap.org URL, wikidata:Q64 or iso:US-CA. |
admin_levelquery | integer | Subdivision admin_level; default: the next level below the parent that exists. |
Example request
curl "https://geo-coder-service.vercel.app/v1/boundaries/r165475/children"Example response
Errors
Failures are RFC 9457 problems. Common ones here: 400 invalid_input, 429 rate_limited.