# Boundaries IO

> US, UK, and Canada coverage with 99.9% SLA uptime. 

For over 6 years, our API has been trusted in production by multi-billion-dollar industry leaders and 200+ teams. Free tier. Sign up & subscribe in minutes.

- [Boundaries.io API](https://docs.boundaries.io/index.md): Postal, neighborhood, and administrative boundary polygons as GeoJSON.
- [Authentication](https://docs.boundaries.io/authentication.md)
- [Get ZIP code boundaries by ZIP list](https://docs.boundaries.io/api-reference/zip-codes-v1/get-zip-code-boundaries-by-zip-list.md): Request body is a JSON array of ZIP codes. Returns their boundaries; combine=true merges them into one geometry. Optional flags: showDetails, combine, showCenter, showEnvelope, fillHoles, showSpecial (include special/PO-box ZIPs), limit.
- [Find ZIP codes intersecting a WKT geometry](https://docs.boundaries.io/api-reference/zip-codes-v1/find-zip-codes-intersecting-a-wkt-geometry.md): Request body is a WKT geometry (POLYGON, MULTIPOLYGON, etc.). Returns all ZIP code boundaries that intersect it. Optional flags: showDetails, combine, showCenter, showEnvelope, fillHoles, showSpecial (include special/PO-box ZIPs), limit.
- [Find ZIP code containing a location](https://docs.boundaries.io/api-reference/zip-codes-v1/find-zip-code-containing-a-location.md): Point-in-polygon lookup: returns the ZIP code boundary containing the given latitude/longitude. Optional flags: showDetails, combine, showCenter, showEnvelope, fillHoles, showSpecial (include special/PO-box ZIPs), limit. Also: showWithinPoint.
- [Find ZIP codes within a radius of a location](https://docs.boundaries.io/api-reference/zip-codes-v1/find-zip-codes-within-a-radius-of-a-location.md): Returns ZIP code boundaries intersecting a circle of the given radius (miles) around latitude/longitude. Optional flags: showDetails, combine, showCenter, showEnvelope, fillHoles, showSpecial (include special/PO-box ZIPs), limit. Also: showCircle.
- [Get ZIP code boundary by FIPS code](https://docs.boundaries.io/api-reference/zip-codes-v1/get-zip-code-boundary-by-fips-code.md): Returns ZIP code boundaries associated with a FIPS code. Optional flags: showDetails, combine, showCenter, showEnvelope, fillHoles, showSpecial (include special/PO-box ZIPs), limit.
- [Get ZIP codes for a city and state](https://docs.boundaries.io/api-reference/zip-codes-v1/get-zip-codes-for-a-city-and-state.md): Returns all ZIP code boundaries within the given city and state. Optional flags: showDetails, combine, showCenter, showEnvelope, fillHoles, showSpecial (include special/PO-box ZIPs), limit.
- [Find city containing a location](https://docs.boundaries.io/api-reference/zip-codes-v1/find-city-containing-a-location.md): Returns the city (derived from ZIP code data) containing the given latitude/longitude.
- [Find ZIP codes within a bounding box](https://docs.boundaries.io/api-reference/zip-codes-v1/find-zip-codes-within-a-bounding-box.md): Returns all ZIP code boundaries intersecting the box defined by south-west and north-east corners (each as lat,lon). Optional flags: showDetails, combine, showCenter, showEnvelope, fillHoles, showSpecial (include special/PO-box ZIPs), limit.
- [Get census tracts by GEOID list](https://docs.boundaries.io/api-reference/census-tracts/get-census-tracts-by-geoid-list.md): Request body is a JSON array of census tract GEOIDs. Returns their boundaries; combine=true merges them into one geometry.
- [Get census tract by GEOID](https://docs.boundaries.io/api-reference/census-tracts/get-census-tract-by-geoid.md): Returns the boundary for a single census tract GEOID. Returns a GeoJSON FeatureCollection.
- [Find census tract containing a location](https://docs.boundaries.io/api-reference/census-tracts/find-census-tract-containing-a-location.md): Point-in-polygon lookup: returns the census tract containing the given latitude/longitude.
- [Get census tract by tract code](https://docs.boundaries.io/api-reference/census-tracts/get-census-tract-by-tract-code.md): Returns the boundary for a census tract by its TRACTCE code.
- [List county names in a state (census tracts)](https://docs.boundaries.io/api-reference/census-tracts/list-county-names-in-a-state-census-tracts.md): Returns the county names available for census tract lookups in the given state.
- [Get census tracts for a county](https://docs.boundaries.io/api-reference/census-tracts/get-census-tracts-for-a-county.md): Returns all census tract boundaries in the given county and state. Returns a GeoJSON FeatureCollection.
- [List census tract GEOIDs for a county](https://docs.boundaries.io/api-reference/census-tracts/list-census-tract-geoids-for-a-county.md): Returns the list of census tract GEOIDs in the given county and state (no geometry).
- [Get census blocks by GEOID list](https://docs.boundaries.io/api-reference/census-blocks/get-census-blocks-by-geoid-list.md): Request body is a JSON array of census block GEOIDs. Returns their boundaries; combine=true merges them into one geometry.
- [Get census block by GEOID](https://docs.boundaries.io/api-reference/census-blocks/get-census-block-by-geoid.md): Returns the boundary for a single census block GEOID. Returns a GeoJSON FeatureCollection.
- [Find census block containing a location](https://docs.boundaries.io/api-reference/census-blocks/find-census-block-containing-a-location.md): Point-in-polygon lookup: returns the census block containing the given latitude/longitude.
- [List county names in a state (census blocks)](https://docs.boundaries.io/api-reference/census-blocks/list-county-names-in-a-state-census-blocks.md): Returns the county names available for census block lookups in the given state.
- [Get census blocks for a county](https://docs.boundaries.io/api-reference/census-blocks/get-census-blocks-for-a-county.md): Returns all census block boundaries in the given county and state. Returns a GeoJSON FeatureCollection.
- [List census block GEOIDs for a county](https://docs.boundaries.io/api-reference/census-blocks/list-census-block-geoids-for-a-county.md): Returns the list of census block GEOIDs in the given county and state (no geometry).
- [Get city boundary by city and state](https://docs.boundaries.io/api-reference/cities/get-city-boundary-by-city-and-state.md): Returns the boundary polygon for a city given its name and state. Returns a GeoJSON FeatureCollection.
- [Convert H3 index from long to hex](https://docs.boundaries.io/api-reference/h3-utilities/convert-h3-index-from-long-to-hex.md): Converts a long (numeric) H3 index to its hex-encoded form.
- [Convert H3 index from hex to long](https://docs.boundaries.io/api-reference/h3-utilities/convert-h3-index-from-hex-to-long.md): Converts a hex-encoded H3 index to its long (numeric) form.
- [Get H3 index at a location](https://docs.boundaries.io/api-reference/h3-utilities/get-h3-index-at-a-location.md): Returns the long-form H3 index containing the given latitude/longitude at the requested resolution (default 10).
- [Get H3 hexagon polygon at a location](https://docs.boundaries.io/api-reference/h3-utilities/get-h3-hexagon-polygon-at-a-location.md): Returns the H3 hexagon polygon containing the given latitude/longitude at the requested resolution (default 10). Returns a GeoJSON FeatureCollection.
- [Distance between two H3 indexes](https://docs.boundaries.io/api-reference/h3-utilities/distance-between-two-h3-indexes.md): Computes the grid distance between two H3 indexes (long form) and returns both hexagons as GeoJSON. Optional flags: showLineBetween (add a connecting line), showPoints (add hexagon center points).
- [Distance between two H3 indexes (hex-encoded)](https://docs.boundaries.io/api-reference/h3-utilities/distance-between-two-h3-indexes-hex-encoded.md): Same as the long-form endpoint but accepts hex-encoded H3 indexes. Optional flags: showLineBetween, showPoints.
- [Get hexagon polygon for an H3 index](https://docs.boundaries.io/api-reference/h3-utilities/get-hexagon-polygon-for-an-h3-index.md): Returns the hexagon polygon for a long-form H3 index. Returns a GeoJSON FeatureCollection.
- [Get hexagon polygon for an H3 index (hex-encoded)](https://docs.boundaries.io/api-reference/h3-utilities/get-hexagon-polygon-for-an-h3-index-hex-encoded.md): Returns the hexagon polygon for a hex-encoded H3 index. Returns a GeoJSON FeatureCollection.
- [Search carrier route boundaries by ZIP code or route](https://docs.boundaries.io/api-reference/carrier-routes/search-carrier-route-boundaries-by-zip-code-or-route.md): Returns carrier route boundaries filtered by one or more zipcode and/or route values. Optional: showDetails.
- [Get carrier routes for a ZIP code](https://docs.boundaries.io/api-reference/carrier-routes/get-carrier-routes-for-a-zip-code.md): Returns all carrier route boundaries within a ZIP code. Optional: resolution.
- [Get carrier route boundary by route ID](https://docs.boundaries.io/api-reference/carrier-routes/get-carrier-route-boundary-by-route-id.md): Returns the boundary for a single carrier route ID. Optional: resolution.
- [Find boundary containing a location](https://docs.boundaries.io/api-reference/boundaries-v1/find-boundary-containing-a-location.md): Point-in-polygon lookup: returns the boundary containing the given latitude/longitude. Optional flags: showDetails (include attribute properties), combine (merge results into one geometry), showCenter (add centroid point), showEnvelope (add bounding envelope), fillHoles (fill interior rings), limit…
- [Find boundaries within a radius of a location](https://docs.boundaries.io/api-reference/boundaries-v1/find-boundaries-within-a-radius-of-a-location.md): Returns boundaries intersecting a circle of the given radius (miles) around latitude/longitude. Optional flags: showDetails (include attribute properties), combine (merge results into one geometry), showCenter (add centroid point), showEnvelope (add bounding envelope), fillHoles (fill interior rings…
- [Get boundary by FIPS code](https://docs.boundaries.io/api-reference/boundaries-v1/get-boundary-by-fips-code.md): Returns the boundary identified by a FIPS code. Optional flags: showDetails (include attribute properties), combine (merge results into one geometry), showCenter (add centroid point), showEnvelope (add bounding envelope), fillHoles (fill interior rings), limit (max features returned). Also: showSpec…
- [Find boundaries within a bounding box](https://docs.boundaries.io/api-reference/boundaries-v1/find-boundaries-within-a-bounding-box.md): Returns all boundaries intersecting the box defined by south-west and north-east corners (each as lat,lon). Optional flags: showDetails (include attribute properties), combine (merge results into one geometry), showCenter (add centroid point), showEnvelope (add bounding envelope), fillHoles (fill in…
- [Get the United States national boundary](https://docs.boundaries.io/api-reference/country/get-the-united-states-national-boundary.md): Returns the national boundary polygon of the United States. Returns a GeoJSON FeatureCollection.
- [Get state or territory boundary by abbreviation](https://docs.boundaries.io/api-reference/states-&-territories/get-state-or-territory-boundary-by-abbreviation.md): Returns the boundary for a state or territory by its USPS abbreviation (e.g. DC, PR, GU). Returns a GeoJSON FeatureCollection.
- [Get state boundary by name](https://docs.boundaries.io/api-reference/states/get-state-boundary-by-name.md): Returns the boundary for a state given as the state query parameter. Returns a GeoJSON FeatureCollection.
- [Get state boundary by name (path)](https://docs.boundaries.io/api-reference/states/get-state-boundary-by-name-path.md): Returns the boundary for a state given in the path. Returns a GeoJSON FeatureCollection.
- [Find state containing a location](https://docs.boundaries.io/api-reference/states/find-state-containing-a-location.md): Point-in-polygon lookup: returns the state containing the given latitude/longitude.
- [Get place boundary by name and state](https://docs.boundaries.io/api-reference/places/get-place-boundary-by-name-and-state.md): Returns the boundary for a place (city, town, CDP) given its name and state. Returns a GeoJSON FeatureCollection.
- [Find place containing a location](https://docs.boundaries.io/api-reference/places/find-place-containing-a-location.md): Point-in-polygon lookup: returns the place containing the given latitude/longitude.
- [List place names in a state](https://docs.boundaries.io/api-reference/places/list-place-names-in-a-state.md): Returns census-designated place names in the given state (no geometry).
- [Search neighborhoods by name, city, county, or state](https://docs.boundaries.io/api-reference/neighborhoods/search-neighborhoods-by-name-city-county-or-state.md): Searches neighborhoods by any combination of name, city, county and state. nameOnly=true returns names without geometry.
- [Get neighborhood boundary by name and state](https://docs.boundaries.io/api-reference/neighborhoods/get-neighborhood-boundary-by-name-and-state.md): Returns the boundary for a neighborhood given its name and state. Returns a GeoJSON FeatureCollection.
- [Find neighborhood containing a location](https://docs.boundaries.io/api-reference/neighborhoods/find-neighborhood-containing-a-location.md): Point-in-polygon lookup: returns the neighborhood containing the given latitude/longitude.
- [List neighborhood names in a state](https://docs.boundaries.io/api-reference/neighborhoods/list-neighborhood-names-in-a-state.md): Returns neighborhood names in the given state (no geometry).
- [List neighborhood names in a city](https://docs.boundaries.io/api-reference/neighborhoods/list-neighborhood-names-in-a-city.md): Returns neighborhood names in the given city and state (no geometry).
- [Get ZIP code H3 index at a location](https://docs.boundaries.io/api-reference/zip-code-h3/get-zip-code-h3-index-at-a-location.md): Returns the H3 index containing the given latitude/longitude at the requested resolution (default 10), with its ZIP code.
- [Get ZIP code H3 hexagon polygon at a location](https://docs.boundaries.io/api-reference/zip-code-h3/get-zip-code-h3-hexagon-polygon-at-a-location.md): Returns the H3 hexagon containing the given latitude/longitude at the requested resolution (default 10), with its ZIP code. Returns a GeoJSON FeatureCollection.
- [Distance between two ZIP code H3 indexes](https://docs.boundaries.io/api-reference/zip-code-h3/distance-between-two-zip-code-h3-indexes.md): Computes the grid distance between two long-form H3 indexes and returns both hexagons with their ZIP codes.
- [Distance between two ZIP code H3 indexes (hex-encoded)](https://docs.boundaries.io/api-reference/zip-code-h3/distance-between-two-zip-code-h3-indexes-hex-encoded.md): Computes the grid distance between two hex-encoded H3 indexes and returns both hexagons with their ZIP codes.
- [Get ZIP code H3 hexagon by H3 index](https://docs.boundaries.io/api-reference/zip-code-h3/get-zip-code-h3-hexagon-by-h3-index.md): Returns the H3 hexagon (long-form index) and the ZIP code it falls in. Returns a GeoJSON FeatureCollection.
- [Get ZIP code H3 hexagon by H3 index (hex-encoded)](https://docs.boundaries.io/api-reference/zip-code-h3/get-zip-code-h3-hexagon-by-h3-index-hex-encoded.md): Returns the H3 hexagon (hex-encoded index) and the ZIP code it falls in. Returns a GeoJSON FeatureCollection.
- [List county names in a state](https://docs.boundaries.io/api-reference/counties/list-county-names-in-a-state.md): Returns the county names in the given state (no geometry).
- [Get county boundary by county and state](https://docs.boundaries.io/api-reference/counties/get-county-boundary-by-county-and-state.md): Returns the boundary for a county given its name and state. Returns a GeoJSON FeatureCollection.
- [Find county containing a location](https://docs.boundaries.io/api-reference/counties/find-county-containing-a-location.md): Point-in-polygon lookup: returns the county containing the given latitude/longitude.
- [Get boundary for a street address](https://docs.boundaries.io/api-reference/addresses/get-boundary-for-a-street-address.md): Resolves a street address (street number, street name, ZIP code) to its containing boundary. Returns a GeoJSON FeatureCollection.

## OpenAPI Specs

- [openapi-us](/openapi-us.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.