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

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

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

## Request

- Base URL: `https://observability.googleapis.com`
- URL: `https://observability.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/traceScopes`
- 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`

List TraceScopes of a project in a particular location.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListTraceScopesResponse: Response for listing TraceScopes.
  - `nextPageToken` string: Optional. If there might be more results than appear in this response, then `next_page_token` is included. To get the next set of results, call the same method again using the value of `next_page_token` as `page_token`.
  - `traceScopes` TraceScope[]: Optional. A list of trace scopes.
    - `createTime` string, google-datetime: Output only. The creation timestamp of the trace scope.
    - `description` string: Optional. Describes this trace scope. The maximum length of the description is 8000 characters.
    - `name` string: Identifier. The resource name of the trace scope. For example: projects/my-project/locations/global/traceScopes/my-trace-scope
    - `resourceNames` string[]: Required. Names of the projects that are included in this trace scope. * `projects/[PROJECT_ID]` A trace scope can include a maximum of 20 projects.
    - `updateTime` string, google-datetime: Output only. The last update timestamp of the trace scope.

---

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