---
title: "Gets all available geo-locations."
method: GET
path: "/subscriptions/{subscriptionId}/locations"
tags: ["Subscriptions"]
---

# Gets all available geo-locations.

`GET /subscriptions/{subscriptionId}/locations`

This operation provides all the locations that are available for resource providers; however, each resource provider may support a subset of this list.

## Query parameters

- `includeExtendedLocations` boolean

## Parameters

- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref

## Response `200`

Azure operation completed successfully.

- LocationListResult — Location list operation response.
  - `value` Location[] — An array of locations.
    - `id` string — The fully qualified ID of the location. For example, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.
    - `subscriptionId` string — The subscription ID.
    - `name` string — The location name.
    - `type` 'Region' | 'EdgeZone' — The location type.
    - `displayName` string — The display name of the location.
    - `regionalDisplayName` string — The display name of the location and its region.
    - `metadata` LocationMetadata — Location metadata information
      - `regionType` 'Physical' | 'Logical' — The type of the region.
      - `regionCategory` 'Recommended' | 'Extended' | 'Other' — The category of the region.
      - `geography` string — The geography of the location.
      - `geographyGroup` string — The geography group of the location.
      - `longitude` string — The longitude of the location.
      - `latitude` string — The latitude of the location.
      - `physicalLocation` string — The physical location of the Azure location.
      - `pairedRegion` PairedRegion[] — The regions paired to this region.
        - `name` string — The name of the paired region.
        - `id` string — The fully qualified ID of the location. For example, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.
        - `subscriptionId` string — The subscription ID.
      - `homeLocation` string — The home location of an edge zone.
    - `availabilityZoneMappings` AvailabilityZoneMappings[] — The availability zone mappings for this region.
      - `logicalZone` string — The logical zone id for the availability zone
      - `physicalZone` string — The fully qualified physical zone id of availability zone to which logical zone id is mapped to
  - `nextLink` string — The URL to get the next set of results.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2015-11-01) `abbabab6a26c` — 2 warning
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2015-11-01) `f69227c406c5` — 1 info
  - added the new optional `query` request parameter `includeExtendedLocations`

[Change history](https://skmtc.dev/azure/apis/resources-microsoft-resources-subscriptions/changes/subscriptions/:subscriptionId/locations/get.md)

---

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