> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get tenants

<Snippet file="graphql/sdk-note.mdx" />

We provide a number of methods for fetching tenants:

1. [Get tenants](#get-tenants) to fetch more than one tenant at a time.
2. [Get tenant by ID](#get-tenant-by-id)
3. [Search for tenants](#search-for-tenants)

For all of these queries you need the following permissions:

* `tenant:read`

### Get tenants

Our API allows you to fetch tenants as a collection using the `tenants` query in GraphQL. This endpoint supports [Pagination](/graphql/pagination).

<Snippet file="graphql/get-tenants.mdx" />

### Get tenant by ID

If you know the tenant's ID in Plain you can use this method to fetch the tenant. Generally speaking it's preferable to use [upsert](./upsert) when you have the full details of the tenant.

<Snippet file="graphql/get-tenant-by-id.mdx" />

### Search for tenants

The `searchTenants` query lets you do a case-insensitive partial match on a tenant's name as well as an exact match on its external ID. The search term must be at least 2 characters long.

<Snippet file="graphql/search-tenants.mdx" />