---
title: "GET /v4/projects/{projectsId}/tenants"
method: GET
path: "/v4/projects/{projectsId}/tenants"
tags: ["projects"]
---

# GET /v4/projects/{projectsId}/tenants

`GET /v4/projects/{projectsId}/tenants`

## Request

- Base URL: `https://jobs.googleapis.com`
- URL: `https://jobs.googleapis.com/v4/projects/{projectsId}/tenants`
- Auth: one of:
  - 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`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/jobs`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/jobs`

Lists all tenants associated with the project.

## Path parameters

- `projectsId` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListTenantsResponse: The List tenants response object.
  - `metadata` ResponseMetadata: Additional information returned to client, such as debugging information.
    - `requestId` string: A unique id associated with this call. This id is logged for tracking purposes.
  - `nextPageToken` string: A token to retrieve the next page of results.
  - `tenants` Tenant[]: Tenants for the current client.
    - `externalId` string: Required. Client side tenant identifier, used to uniquely identify the tenant. The maximum number of allowed characters is 255.
    - `name` string: Required during tenant update. The resource name for a tenant. This is generated by the service when a tenant is created. The format is "projects/{project_id}/tenants/{tenant_id}", for example, "projects/foo/tenants/bar".

---

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