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

# List tenants

`GET /tenants`

Returns all tenants the calling user is a member of. Used by the console to populate the tenant switcher. With API key auth this is scoped to the key's tenant.

## Response `200`

Tenants accessible to the caller

- TenantInfo[]
  - `created_at` string, date-time, required — Resource creation timestamp (RFC 3339 UTC).
  - `id` integer, required
  - `name` string, required
  - `protected` boolean, required — When `true`, deletion is hardened: the DELETE request must include a one-time confirmation code emailed to the tenant address. Obtain the code via `PUT /tenants/{tenant_id}/request_code` with `action = "delete_tenant"` and pass it as the `code` query parameter on the DELETE call.
  - `remarks` string, nullable
  - `updated_at` string, date-time, required — Resource last-update timestamp (RFC 3339 UTC).

## Other responses

- `401` — No active session or API key

---

[API](https://skmtc.net/laserdata/apis/laserdata-cloud-core-api.md) · [All operations](https://skmtc.net/laserdata/apis/laserdata-cloud-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/laserdata/laserdata-cloud-core-api/revisions/db81a447bba9/schema)