Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-azure-maps:microsoft-azure-maps-search-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Maps Search API
version: '2026-01-01'
description: Azure Maps Search REST APIs
x-typespec-generated:
- emitter: '@azure-tools/typespec-autorest'
security:
- AadToken:
- https://atlas.microsoft.com/.default
- AzureKey: []
- SasToken: []
tags:
- name: Search
paths:
/search/polygon:
get:
operationId: Search_GetPolygon
summary: Use to get polygon data of a geographical area shape such as a city or a…
description: 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.
parameters:
- $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: x-ms-client-id
in: header
description: Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. For more information on using Microsoft Entra ID security in Azure Maps, see [Manage authentication in Azure Maps](/azure/azure-maps/how-to-manage-authentication).
required: false
x-ms-client-name: clientId
schema:
type: string
- name: Accept-Language
in: header
description: 'Language in which search results should be returned.
Please refer to [Supported Languages](/azure/azure-maps/supported-languages?pivots=service-latest) for details.'
required: false
x-ms-client-name: acceptLanguage
schema:
type: string
- name: coordinates
in: query
description: 'A point on the earth specified as a longitude and latitude. Example: &coordinates=lon,lat'
required: true
style: form
explode: false
schema:
type: array
items:
type: number
format: double
maxItems: 2
minItems: 2
- name: view
in: query
description: 'A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter Geopolitical disputed borders and labels to align with the specified user region. By default, the View parameter is set to "Auto" even if you haven''t defined it in the request.
Please refer to [Supported Views](https://aka.ms/AzureMapsLocalizationViews) for details and to see the available Views.'
required: false
schema:
type: string
- name: resultType
in: query
description: The geopolitical concept to return a boundary for. If not specified, the default is `countryRegion` result type.
required: false
x-ms-enum:
name: BoundaryResultTypeEnum
modelAsString: true
values:
- name: countryRegion
value: countryRegion
description: A country or region.
- name: adminDistrict
value: adminDistrict
description: First administrative level within the country/region, such as a state or a province.
- name: adminDistrict2
value: adminDistrict2
description: Second administrative level within the country/region, such as a county.
- name: postalCode
value: postalCode
description: The smallest postal code category, such as a zip code.
- name: postalCode2
value: postalCode2
description: 'The next largest postal code category after `postalCode` that is created by aggregating
`postalCode` areas.'
- name: postalCode3
value: postalCode3
description: 'The next largest postal code category after `postalCode2` that is created by aggregating
`postalCode2` areas.'
- name: postalCode4
value: postalCode4
description: 'The next largest postal code category after `postalCode3` that is created by aggregating
`postalCode3` areas.'
- name: neighborhood
value: neighborhood
description: 'A locally recognized area within a populated place, often with informal or culturally
defined boundaries.'
- name: locality
value: locality
description: A concentrated area of human settlement, such as a city, town or village.
schema:
type: string
enum:
- countryRegion
- adminDistrict
- adminDistrict2
- postalCode
- postalCode2
- postalCode3
- postalCode4
- neighborhood
- locality
default: countryRegion
- name: resolution
in: query
description: Resolution determines the amount of points to send back. If not specified, the default is medium resolution.
required: false
x-ms-enum:
name: ResolutionEnum
modelAsString: true
values:
- name: small
value: small
description: Returns the boundary geometry with the fewest points.
- name: medium
value: medium
description: Returns the boundary geometry with the same number of points as `small` or more.
- name: large
value: large
description: Returns the boundary geometry with the same number of points as `medium` or more.
- name: huge
value: huge
description: Returns the boundary geometry with the same number of points as `large` or more.
schema:
type: string
enum:
- small
- medium
- large
- huge
default: medium
responses:
'200':
description: The request has succeeded.
content:
application/geo+json:
schema:
$ref: '#/components/schemas/Boundary'
application/json:
schema:
$ref: '#/components/schemas/Boundary'
default:
description: An unexpected error response.
headers:
x-ms-error-code:
description: String error code indicating what went wrong.
schema:
type: string
content:
application/geo+json:
schema:
$ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
application/json:
schema:
$ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
tags:
- Search
components:
schemas:
GeoJsonGeometryCollection:
type: object
description: 'A valid `GeoJSON GeometryCollection` object type. Please refer to [RFC
7946](https://tools.ietf.org/html/rfc7946#section-3.1.8) for details.'
properties:
geometries:
type: array
description: 'Contains a list of valid `GeoJSON` geometry objects. **Note** that coordinates
in GeoJSON are in x, y order (longitude, latitude).'
items:
$ref: '#/components/schemas/GeoJsonGeometry'
required:
- geometries
allOf:
- $ref: '#/components/schemas/GeoJsonGeometry'
x-ms-discriminator-value: GeometryCollection
BoundaryProperties:
type: object
description: '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.'
properties:
name:
type: string
description: The display name of the geographical area, for example, `"Bellevue"` for a city boundary.
copyright:
type: string
description: 'The Azure Maps API copyright and usage notice that applies to this response. Distinct
from the per-geometry data-provider attributions in `geometriesCopyright`.'
copyrightUrl:
type: string
description: 'A URL to Azure Maps copyright and licensing information for the API and its underlying
data sources.'
geometriesCopyright:
type: array
description: '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`.'
items:
$ref: '#/components/schemas/GeometryCopyright'
FeatureTypeEnum:
type: string
description: '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).'
enum:
- Feature
x-ms-enum:
name: FeatureTypeEnum
modelAsString: true
values:
- name: Feature
value: Feature
description: 'The `GeoJSON Feature` object type. Appears on every Feature inside a `FeatureCollection`
response, and at the root of the `Get Polygon` response.'
Azure.Core.Foundations.Error:
type: object
description: The error object.
properties:
code:
type: string
description: One of a server-defined set of error codes.
message:
type: string
description: A human-readable representation of the error.
target:
type: string
description: The target of the error.
details:
type: array
description: An array of details about specific errors that led to this reported error.
items:
$ref: '#/components/schemas/Azure.Core.Foundations.Error'
innererror:
$ref: '#/components/schemas/Azure.Core.Foundations.InnerError'
description: An object containing more specific information than the current object about the error.
required:
- code
- message
Azure.Core.Foundations.ErrorResponse:
type: object
description: A response containing error details.
properties:
error:
$ref: '#/components/schemas/Azure.Core.Foundations.Error'
description: The error object.
required:
- error
GeometryCopyright:
type: object
description: 'A single per-geometry data-provider attribution entry within
`BoundaryProperties.geometriesCopyright`. Identifies the source of one geometry in
the parent `Boundary.geometry.geometries` array.'
properties:
sourceName:
type: string
description: An identifier for the data provider that supplied this geometry.
copyright:
type: string
description: 'The human-readable attribution string for the data provider. For example, `"TomTom"`.
May be a vendor name or a fuller copyright notice.'
Boundary:
type: object
description: '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.'
properties:
type:
$ref: '#/components/schemas/FeatureTypeEnum'
description: 'The `GeoJSON` object type. Always `Feature`, as defined in
[RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).'
geometry:
$ref: '#/components/schemas/GeoJsonGeometryCollection'
description: 'A `GeometryCollection` of one or more `Polygon` or `MultiPolygon` shapes whose coordinates
define the outline of the requested area in WGS 84 longitude/latitude order, as defined
by [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.8).'
properties:
$ref: '#/components/schemas/BoundaryProperties'
description: 'Display name and copyright attribution for the returned area. See `BoundaryProperties`
for the per-property shape.'
required:
- geometry
GeoJsonObjectType:
type: string
description: 'Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object
types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon,
GeometryCollection, Feature and FeatureCollection.'
enum:
- Point
- MultiPoint
- LineString
- MultiLineString
- Polygon
- MultiPolygon
- GeometryCollection
- Feature
- FeatureCollection
x-ms-enum:
name: GeoJsonObjectType
modelAsString: false
values:
- name: GeoJsonPoint
value: Point
description: '`GeoJSON Point` geometry.'
- name: GeoJsonMultiPoint
value: MultiPoint
description: '`GeoJSON MultiPoint` geometry.'
- name: GeoJsonLineString
value: LineString
description: '`GeoJSON LineString` geometry.'
- name: GeoJsonMultiLineString
value: MultiLineString
description: '`GeoJSON MultiLineString` geometry.'
- name: GeoJsonPolygon
value: Polygon
description: '`GeoJSON Polygon` geometry.'
- name: GeoJsonMultiPolygon
value: MultiPolygon
description: '`GeoJSON MultiPolygon` geometry.'
- name: GeoJsonGeometryCollection
value: GeometryCollection
description: '`GeoJSON GeometryCollection` geometry.'
- name: GeoJsonFeature
value: Feature
description: '`GeoJSON Feature` object.'
- name: GeoJsonFeatureCollection
value: FeatureCollection
description: '`GeoJSON FeatureCollection` object.'
Azure.Core.Foundations.InnerError:
type: object
description: An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.
properties:
code:
type: string
description: One of a server-defined set of error codes.
innererror:
$ref: '#/components/schemas/Azure.Core.Foundations.InnerError'
description: Inner error.
GeoJsonGeometry:
type: object
description: '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.'
properties:
type:
$ref: '#/components/schemas/GeoJsonObjectType'
description: '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:
type: array
description: Bounding box. Projection used - EPSG:3857. Please refer to [RFC 7946](https://datatracker.ietf.org/doc/html/rfc7946#section-5) for details.
minItems: 4
maxItems: 4
items:
type: number
format: double
discriminator:
propertyName: type
required:
- type
parameters:
Azure.Core.Foundations.ApiVersionParameter:
name: api-version
in: query
description: The API version to use for this operation.
required: true
x-ms-parameter-location: method
x-ms-client-name: apiVersion
schema:
type: string
minLength: 1
securitySchemes:
AadToken:
type: oauth2
flows:
implicit:
scopes:
https://atlas.microsoft.com/.default: ''
authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
description: 'These are the [Microsoft Entra OAuth 2.0](https://docs.microsoft.com/azure/active-directory/develop/v1-overview) Flows. When paired with [Azure role-based access](https://docs.microsoft.com/azure/role-based-access-control/overview) control it can be used to control access to Azure Maps REST APIs. Azure role-based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a built-in role or a custom role composed of one or more permissions to Azure Maps REST APIs.
To implement scenarios, we recommend viewing [authentication concepts](https://aka.ms/amauth). In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes.
> [!NOTE]
>
> * This security definition **requires** the use of the `x-ms-client-id` header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the [Maps management API](https://aka.ms/amauthdetails).
> * The `Authorization URL` is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Microsoft Entra ID configurations.
> * The Azure role-based access control is configured from the [Azure management plane](https://aka.ms/amrbac) via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.
> * Usage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for configuration based setup of an application for multiple use cases.
> * For more information on Microsoft identity platform, see [Microsoft identity platform overview](https://learn.microsoft.com/entra/identity-platform/v2-overview).'
AzureKey:
type: apiKey
description: 'This is a shared key that is provisioned when you [Create an Azure Maps account](https://docs.microsoft.com/azure/azure-maps/quick-demo-map-app#create-an-azure-maps-account) in the Azure portal or using PowerShell, CLI, Azure SDKs, or REST API.
With this key, any application can access all REST API. In other words, this key can be used as a master key in the account that they are issued in.
For publicly exposed applications, our recommendation is to use the [confidential client applications](https://docs.microsoft.com/azure/azure-maps/authentication-best-practices#confidential-client-applications) approach to access Azure Maps REST APIs so your key can be securely stored.'
name: subscription-key
in: header
SasToken:
type: apiKey
description: 'This is a shared access signature token is created from the List SAS operation on the [Azure Maps resource](https://aka.ms/amauth) through the Azure management plane via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.
With this token, any application is authorized to access with Azure role-based access controls and fine-grain control to the expiration, rate, and region(s) of use for the particular token. In other words, the SAS Token can be used to allow applications to control access in a more secured way than the shared key.
For publicly exposed applications, our recommendation is to configure a specific list of allowed origins on the [Map account resource](https://aka.ms/amauth) to limit rendering abuse and regularly renew the SAS Token.'
name: SAS Token
in: header
x-ms-parameterized-host:
hostTemplate: '{endpoint}'
useSchemePrefix: false
parameters:
- name: endpoint
in: path
description: The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography or a sovereign cloud, see [Azure Maps geographic scope](https://learn.microsoft.com/azure/azure-maps/geographic-scope).
required: true
type: string
format: uri
default: https://atlas.microsoft.com
x-ms-skip-url-encoding: true