---
title: "Lookup boundaries by coordinates"
method: GET
path: "/v1/data/boundaries"
tags: ["Boundaries"]
---

# Lookup boundaries by coordinates

`GET /v1/data/boundaries`

## Request

- Base URL: `https://api.mapulus.com`
- URL: `https://api.mapulus.com/v1/data/boundaries`
- Auth: HTTP bearer

Resolve a latitude/longitude point to its containing statistical boundaries.

Returns all boundary types (SA1-SA4, LGA, postcode, suburb, etc.) that contain the
given point, along with H3 hexagonal grid indices at resolutions 3-9 and any
matching planning regions.

Uses an H3 crosswalk table for fast lookups with a spatial query fallback.

## Query parameters

- `lat` number, required: Latitude in decimal degrees.
- `lng` number, required: Longitude in decimal degrees.
- `types` string, nullable: Comma-separated boundary types to return (e.g. `sa2,lga`). Returns all types if omitted.

## Response `200`

Matching boundaries, planning regions, and H3 indices for the given point.

- ResponseEnvelopeBoundaryLookupResponse
  - `data` BoundaryLookupResponse, required: Result of resolving a point to its containing boundaries.
    - `location` PointLocation, required: A geographic point as longitude/latitude.
      - `lng` number, required: Longitude in decimal degrees.
      - `lat` number, required: Latitude in decimal degrees.
    - `boundaries` object: Containing boundaries keyed by type (e.g. `sa2`, `lga`).
    - `planning_regions` PlanningRegionRef[]: Matching planning regions.
      - `region_id` string, required: Planning region identifier.
      - `region_type` string, required: Planning region type (e.g. `phn`).
      - `name` string, required: Planning region name.
      - `state` string, nullable: State or territory code.
    - `h3_indices` object: H3 hexagonal indices at resolutions 3-9.
  - `meta` ResponseMeta: Response metadata.
    - `request_id` string, nullable
    - `pagination` PaginationMeta: Pagination metadata for list responses.
      - `total` integer, required: Total number of matching records.
      - `limit` integer, required: Maximum records returned per page.
      - `offset` integer, required: Number of records skipped.
      - `has_more` boolean, required: Whether more records exist beyond this page.
    - `demographics` DemographicsMeta: Demographics-specific metadata returned with census data endpoints.
      - `topics_included` string[], required: Topics included in the response.
      - `topics_available` string[]: Additional topics available but not requested.
    - `sources` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mapulus/apis/mapulus-api.md) · [All operations](https://skmtc.dev/mapulus/apis/mapulus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapulus/apis/mapulus-api/revisions/b99766fa053f?raw)