---
title: "Tenant Get"
method: GET
path: "/1/tenants/{tenantId}"
tags: ["Tenant"]
---

# Tenant Get

`GET /1/tenants/{tenantId}`

## Request

- Base URL: `http://localhost:3000/api`
- URL: `http://localhost:3000/api/1/tenants/{tenantId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ironcorelabs/apis/vendor-api-bridge/docs/1/tenants/:tenantId/get.ts> (a function with typed inputs; its response is checked against the schema)

Get information about the provided tenant.

## Headers

- `icl-requestor-id` string, required

## Response `200`

Result of getting a tenant. Same as TenantCreateResponse but with the addition of `primaryKmsConfigId`.

- TenantGetResponse: Result of getting a tenant. Same as TenantCreateResponse but with the addition of `primaryKmsConfigId`.
  - `id` string, required: Tenant ID
  - `name` string, required
  - `archived` boolean, required
  - `tenantCreatedConfigs` boolean, required
  - `invited` boolean, required: If true, this tenant has been invited, but not yet accepted their invitation.
  - `keyLeasingRequired` boolean, required: Whether key leasing must be enabled for all KMS configurations assigned to this tenant.
  - `primaryKmsConfigId` integer, nullable, required
  - `tags` Tag[], required
    - `id` integer, required: Tag ID
    - `tagText` string, required: Human-readable text associated with tag
    - `default` boolean, required: Whether this is the default tag for tenants/service accounts
    - `created` string, required: RFC3339 timestamp
  - `createdBy` CreatedBy, required: Metadata about creating user/service
    - `id` string, required: Creator ID
    - `name` string, required: Creator name
    - `type` 'Tsp' | 'Admin' | 'Va', required: Creator type
  - `created` string, required: RFC3339 timestamp
  - `updated` string, required: RFC3339 timestamp

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/ironcorelabs/apis/vendor-api-bridge.md) - [All operations](https://skmtc.dev/ironcorelabs/apis/vendor-api-bridge/llms.txt) - [OpenAPI document](https://skmtc.dev/ironcorelabs/apis/vendor-api-bridge/revisions/5c0e553ffa21?raw)