# Tenants: Get a tenant (https://docs.envocal.ai/api-reference/tenants/get-a-tenant/)

> Requires tenants:read

## GET `/v1/tenants/{tenantId}`

**Required permission:** `tenants:read`

### Parameters

| Name | In | | Type | Description |
| --- | --- | --- | --- | --- |
| `tenantId` | path | required | string | Tenant id, or `current` for the key's own tenant. Must be the key's tenant or one of its sub-tenants. |

### Responses

**200** — TenantDto: The tenant.

| Field | Type | | Description |
| --- | --- | --- | --- |
| `id` | string | required | Tenant id. |
| `name` | string | required | Display name. |
| `parentId` | string | nullable | Parent tenant id. |
| `type` | `main` \| `sub` \| `customer` | required | Tenant type. Determines which child types it may contain: `main` → `main`, `sub`, `customer`; `sub` → `customer`; `customer` has no children. |
| `domain` | string | nullable | Email domain of the organisation (e.g. `example.com`), unique across tenants. Optional. |
| `extraId` | string | nullable | Your own reference for this tenant (e.g. a CRM or billing id). Optional, free text. |
| `region` | string | required | Data region the tenant's data lives in (`eu`); chosen when the tenant was created, and carried by its API keys (`evk_eu_...`). |

**401**: Missing, invalid, revoked or expired API key.

**403**: The key lacks the required permission, or the tenant/resource is outside its reach.

**404**: Tenant not found.

**429**: Rate limit exceeded. Retry after the number of seconds in the Retry-After header.

### Example

```bash
curl -X GET "https://api.envocal.ai/v1/tenants/current" \
  -H "Authorization: Bearer evk_eu_..."
```