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

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

`GET /search/polygon/{format}`

The `Get Polygon` API is an HTTP `GET` request that returns geometry data such as a city or country/region outline for a set of entities, previously retrieved from an online search request in GeoJSON format. The geometry ID is returned in the `sourceGeometry` object under "geometry" and "id" in either a Search Address or Search Fuzzy call.

 A geometry ID retrieved from an online search endpoint has a limited lifetime, it is not recommended to store geometry IDs in persistent storage for later referral. It is expected that a request to the Polygon method is made within a  few minutes of the request to the online search method that provided the ID. The service allows for batch  requests up to 20 identifiers.

## Query parameters

- `api-version` string, required
- `geometries` string[], required

## Parameters

- `../../../Common/preview/1.0/common.json#/components/parameters/ClientId` — unresolved $ref
- `../../../Common/preview/1.0/common.json#/components/parameters/JsonFormat` — unresolved $ref

## Response `200`

OK

- PolygonResult — This object is returned from a successful Search Polygon call
  - `additionalData` Polygon[] — Results array
    - `providerID` string — ID of the returned entity
    - `geometryData` GeoJsonObject — unresolved $ref

## Other responses

- `default` — unresolved $ref

## Changes

- **2025-10-15** (1.0) `69718fe8c37a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/maps-search/changes/search/polygon/:format/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/1e2d1fda19da/schema)