---
title: "Use to get polygon data of a geographical area shape such as a city or a country region."
method: GET
path: "/search/polygon"
---

# Use to get polygon data of a geographical area shape such as a city or a country region.

`GET /search/polygon`

The `Get Polygon` API is an HTTP `GET` request that supplies polygon data of a geographical area outline such as a city or a country region.

## Query parameters

- `api-version` string, required
- `coordinates` number[], required
- `view` string
- `resultType` 'countryRegion' | 'adminDistrict' | 'adminDistrict2' | 'postalCode' | 'postalCode2' | 'postalCode3' | 'postalCode4' | 'neighborhood' | 'locality'
- `resolution` 'small' | 'medium' | 'large' | 'huge'

## Headers

- `x-ms-client-id` string
- `Accept-Language` string

## Response `200`

The request has succeeded.

- Boundary — The successful response body returned by `Get Polygon`. Encoded as a [`GeoJSON Feature`](https://www.rfc-editor.org/rfc/rfc7946#section-3.2) whose `geometry` is a `GeometryCollection` of one or more `Polygon` or `MultiPolygon` shapes describing the outline of the requested geographical area, and whose `properties` carry the area's display name and copyright attribution.
  - `type` 'Feature' — The `GeoJSON` object type for `Feature` objects. Tags each entry inside the `features` array of a `FeatureCollection` response (geocoding, reverse geocoding, autocomplete) and appears at the root of the `Get Polygon` response. The only value is `Feature`, as defined in [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).
  - `geometry` GeoJsonGeometryCollection, required — A valid `GeoJSON` geometry object. The type must be one of the seven valid GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details.
    - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'GeometryCollection' | 'Feature' | 'FeatureCollection', required — Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.
    - `bbox` number[] — Bounding box. Projection used - EPSG:3857. Please refer to [RFC 7946](https://datatracker.ietf.org/doc/html/rfc7946#section-5) for details.
  - `properties` BoundaryProperties — The `properties` payload of a `Boundary`. Carries the display name of the returned geographical area along with copyright attribution, both an API-wide notice and per-geometry data-provider credits.
    - `name` string — The display name of the geographical area, for example, `"Bellevue"` for a city boundary.
    - `copyright` string — The Azure Maps API copyright and usage notice that applies to this response. Distinct from the per-geometry data-provider attributions in `geometriesCopyright`.
    - `copyrightUrl` string — A URL to Azure Maps copyright and licensing information for the API and its underlying data sources.
    - `geometriesCopyright` GeometryCopyright[] — Per-geometry data-provider attribution. Each entry corresponds positionally to the matching shape in the parent `Boundary.geometry.geometries` array — entry `i` describes the source of geometry `i`.
      - `sourceName` string — An identifier for the data provider that supplied this geometry.
      - `copyright` string — The human-readable attribution string for the data provider. For example, `"TomTom"`. May be a vendor name or a fuller copyright notice.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (1.0) `adc95bd8c78a` — 1 info
  - added the new optional `header` request parameter `x-ms-client-id`
- **2026-07-13** (1.0) `0e0c2063abbc` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (1.0) `b9c8eccff00d` — 1 info
  - endpoint added
- **2025-10-15** (1.0) `69718fe8c37a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/maps-search/changes/search/polygon/get.md)

---

[API](https://skmtc.dev/azure/apis/maps-search.md) · [All operations](https://skmtc.dev/azure/apis/maps-search/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/maps-search/revisions/adc95bd8c78a/schema)