---
title: "List deployable tenant organizations"
method: GET
path: "/v2/deploymentPolicies/tenants"
tags: ["Deployment policies"]
---

# List deployable tenant organizations

`GET /v2/deploymentPolicies/tenants`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/deploymentPolicies/tenants`
- Auth: HTTP bearer

Returns a paginated list of tenant organizations that the calling organization can deploy to.

- **Parent organizations**: Returns all tenant organizations.
- **Tenant organizations**: Returns tenant organizations that the calling tenant has been granted deployment capabilities to.

### Usage notes
- To perform this operation, you must use API credentials owned by a user assigned an account type with the **Manage deployment policies** permission enabled.

## Query parameters

- `pageToken` string
- `pageSize` integer
- `search` string

## Response `200`

The response body.

- DeploymentPoliciesListDeployableTenantsResponse200
  - `entries` V2DeploymentPoliciesTenantsGetResponsesContentApplicationJsonSchemaEntriesItems[], required: Array of results returned by the endpoint
    - `tenantOrganizationId` string, required: Unique identifier of a tenant organization that can be deployed to.
    - `tenantOrganizationSlug` string, required: URL identifier for the tenant organization.
    - `tenantOrganizationName` string, required: Display name of the tenant organization.
  - `nextPageToken` string: A string that can be passed to the `pageToken` parameter in the next request to fetch the next page of results. Not present in the last page of results. **Must be treated as an opaque string.**

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)