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

# GET /tenants

`GET /tenants`

| Permissions |
| ------- |
| 10207   |

## Response `200`

Array of Tenant model instances

- TenantWithRelations[]
  - `deleted` boolean
  - `deletedOn` string, date-time, nullable
  - `deletedBy` string, nullable
  - `createdOn` string, date-time
  - `modifiedOn` string, date-time
  - `createdBy` string
  - `modifiedBy` string
  - `id` string
  - `name` string, required — name of the tenant
  - `status` 0 | 1 | 2 | 3 | 4 | 5, required — status of a tenant, it can be - 0(active), 1(provisioning),2(deprovisioning),3(inactive)
  - `key` string, required — a short string used to identify a tenant. This is also used as the namespace and subdomain for this particular tenant
  - `spocUserId` string — user id of the admin user who acts as a spoc for this tenant.
  - `domains` string[], required
  - `leadId` string — id of the lead from which this tenant was generated. this is optional as a tenant can be created without this lead.
  - `addressId` string — id of the address of the tenant
  - `contacts` Contact[]
    - `deleted` boolean
    - `deletedOn` string, date-time, nullable
    - `deletedBy` string, nullable
    - `createdOn` string, date-time
    - `modifiedOn` string, date-time
    - `createdBy` string
    - `modifiedBy` string
    - `id` string
    - `firstName` string, required — first name of the lead
    - `lastName` string, required — last name of the lead
    - `email` string, required — email id of the contact
    - `isPrimary` boolean, required — boolean value denoting if the contact is a primary contact for it's tenant.
    - `type` string — type of the contact
    - `tenantId` string — tenant id this contact belongs to
  - `resources` Resource[]
    - `deleted` boolean
    - `deletedOn` string, date-time, nullable
    - `deletedBy` string, nullable
    - `createdOn` string, date-time
    - `modifiedOn` string, date-time
    - `createdBy` string
    - `modifiedBy` string
    - `id` string
    - `externalIdentifier` string, required — identifier for the resource in the external system it was provisioned
    - `type` string, required — type of the resource like storage, compute, etc
    - `metadata` object, required — any type specific metadata of the resource like connection info, size, etc
    - `tenantId` string — id of the tenant for which this resource is provisioned
  - `lead` Lead — this model represents a lead that could eventually be a tenant in the system
    - `deleted` boolean
    - `deletedOn` string, date-time, nullable
    - `deletedBy` string, nullable
    - `createdOn` string, date-time
    - `modifiedOn` string, date-time
    - `createdBy` string
    - `modifiedBy` string
    - `id` string
    - `firstName` string, required — first name of the lead
    - `lastName` string, required — last name of the lead
    - `companyName` string, required — name of the lead's company
    - `email` string, required — email of the lead
    - `isValidated` boolean, required — whether the lead`s email has been validated or not
    - `addressId` string — id of the address of the lead
  - `foreignKey` unknown
  - `address` Address — this model represents the address of a company or lead
    - `deleted` boolean
    - `deletedOn` string, date-time, nullable
    - `deletedBy` string, nullable
    - `createdOn` string, date-time
    - `modifiedOn` string, date-time
    - `createdBy` string
    - `modifiedBy` string
    - `id` string
    - `address` string — address of the company
    - `city` string — city of the company
    - `state` string — state of the company
    - `zip` string — zip code of the company
    - `country` string, required — country of the company

---

[API](https://skmtc.dev/sourcefuse/apis/tenant-management-service.md) · [All operations](https://skmtc.dev/sourcefuse/apis/tenant-management-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sourcefuse/tenant-management-service/revisions/0dce7cf133e9/schema)
