---
title: "List Tenants"
method: GET
path: "/v1/auth/tenants"
tags: ["auth", "auth"]
---

# List Tenants

`GET /v1/auth/tenants`

## Request

- Base URL: `https://api.elaan.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elaan.io/v1/auth/tenants`
- Auth: none declared

The tenants the signed-in user belongs to — for the tenant picker /
switcher. Any valid token identifies the user; the tenants come from their
memberships, not from the token's current tenant.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- TenantResponse[]
  - `tenant_id` string, required
  - `name` string, required
  - `role` string, required
  - `is_default` boolean, required
  - `status` string: "active" or "archived". An archived account is hidden from the switcher and can no longer send — the trigger refuses it and fan-out skips it. Reversible via unarchive; data is retained.

## Other responses

- `422`: Validation Error

---

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