---
title: "Batch lookup boundaries"
method: POST
path: "/v1/data/boundaries/search"
tags: ["Boundaries"]
---

# Batch lookup boundaries

`POST /v1/data/boundaries/search`

## Request

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

Resolve multiple locations to their containing boundaries in a single request.

Accepts up to 100 locations. Each location is resolved independently.

## Request body

- BoundarySearchRequest: Request body for batch boundary search.
  - `locations` BoundarySearchItem[], required: Locations to resolve (max 100).
    - `id` string, required: Client-provided identifier for this location.
    - `location` PointLocation, required: A geographic point as longitude/latitude.
      - `lng` number, required: Longitude in decimal degrees.
      - `lat` number, required: Latitude in decimal degrees.

## Response `200`

Boundary results for each location in the batch.

- ResponseEnvelopeBoundarySearchResponse
  - `data` BoundarySearchResponse, required: Response containing boundary results for each location.
    - `results` BoundarySearchResultItem[], required: Boundary results for each input location.
      - `id` string, required: Client-provided identifier.
      - `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.
      - `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.
  - `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)