---
title: "GET /v1/projects/{projectsId}/locations"
method: GET
path: "/v1/projects/{projectsId}/locations"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations

`GET /v1/projects/{projectsId}/locations`

## Request

- Base URL: `https://cloudlocationfinder.googleapis.com`
- URL: `https://cloudlocationfinder.googleapis.com/v1/projects/{projectsId}/locations`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/cloud-platform`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

## Path parameters

- `projectsId` string, required

## Query parameters

- `extraLocationTypes` string[]
- `filter` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListLocationsResponse: The response message for Locations.ListLocations.
  - `locations` Location[]: A list of locations that matches the specified filter in the request.
    - `displayName` string: The friendly name for this location, typically a nearby city name. For example, "Tokyo".
    - `labels` object: Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"}
    - `locationId` string: The canonical id for this location. For example: `"us-east1"`.
    - `metadata` object: Service-specific metadata. For example the available capacity at the given location.
    - `name` string: Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"`
  - `nextPageToken` string: The standard List next-page token.

---

[API](https://skmtc.dev/google/apis/cloudlocationfinder.md) - [All operations](https://skmtc.dev/google/apis/cloudlocationfinder/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/cloudlocationfinder/revisions/faaf90ffca84?raw)