---
name: query-tenants
description: List tenants and get specific tenant details. Use this sub-skill to search for tenants or filter tenants by attributes (region, plan, status).
---

# Available Actions

## List Tenants

List tenants with optional complex filtering. Note that array filters take comma-separated values.

API Path: `/tenants`

Method: `GET`

### Query parameters

- `page` (integer, optional): page number. Default: `1`. Must be greater than `0`.
- `per_page` (integer, optional): number of items per page. Default: `100`. Must be greater than `0` and less than or equal to `100`.
- `search` (string, optional): search keyword (e.g. `demo`).
- `sort_by` (string, optional): sort field. Valid values: `timezone`, `created_at`.
- `order` (string, optional): sort order. Valid values: `asc`, `desc`.
- `status` (string[], optional): filter by status. Valid values: `pending`, `active`, `inactive`, `deleted`, `cleared`.
- `kind` (string[], optional): filter by kind. Valid values: `internal`, `external`.
- `plan` (string[], optional): filter by plan. Valid values: `new_user`, `free_trial`, `poc`, `on_demand`.
- `region` (string[], optional): filter by region. Valid values: `APAC`, `EMEA`, `JAPAN`, `NA`, `UNKNOWN`.
- `segmentation` (string[], optional): filter by segmentation. Valid values: `SKA`, `KA`, `SMB`.

## Get Tenant

Get detailed information about a specific tenant.

API Path: `/tenants/{tenant_id}`

Method: `GET`