---
title: "Get all tenants"
method: GET
path: "/api/v1/tenants"
tags: ["tenant"]
---

# Get all tenants

`GET /api/v1/tenants`

This can only be done by a logged in user who has the required privileges.

## Query parameters

- `meta` boolean

## Response `200`

List of all tenants

- object
  - `data` Tenant[]
    - `_id` string — id of tenant organization
    - `name` string, required — name of tenant organization
    - `status` 'ACTIVE' | 'PENDING' | 'DISABLED'
    - `confirmed` boolean — true, if the confirmation link/email has been triggered

## Changes

- **2021-09-17** `1134b4a506a5` — 1 breaking, 1 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the optional property `data` to the response with the `200` status
- **2021-03-17** `c9349f4e8a10` — 1 info
  - added the new optional `query` request parameter `meta`
- **2019-08-15** `42619b8ccbbe` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/changes/api/v1/tenants/get.md)

---

[API](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih.md) · [All operations](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintegrationhub/iam-api-for-oih/revisions/016871a170fd/schema)