---
title: "List tenants the current user can access"
method: GET
path: "/api/tenant-managements/clients"
tags: ["Tenant Management"]
---

# List tenants the current user can access

`GET /api/tenant-managements/clients`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/tenant-managements/clients`
- Auth: none declared

## Query parameters

- `include_stats` boolean
- `sort_by` 'name' | 'waiting_review_documents_count' | 'last_activity_at', nullable
- `sort_ascending` boolean

## Response `200`

Successful Response

- ListAccessibleTenantsResponse
  - `results` AccessibleTenantDTO[], required
    - `aggregate_id` string, uuid, required
    - `name` string, required
    - `vat_id` string, nullable, required
    - `relationship_type` 'OWN' | 'CLIENT', required: How a tenant relates to the requesting user in the accessible-tenants list.
    - `relationship_id` string, uuid, nullable
    - `stats` AccessibleTenantStatsDTO
      - `waiting_review_documents_count` integer
      - `last_activity_at` string, date-time, nullable
      - `total_documents_this_month` integer
      - `subscription_plan` 'TRIAL' | 'FREE' | 'PROFESSIONAL' | 'ENTERPRISE'
      - `business_unit_count` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/typless/apis/typless-api.md) · [All operations](https://skmtc.dev/typless/apis/typless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typless/apis/typless-api/revisions/d614787a47ef?raw)