Get tenant
PlatformRetrieve tenant metadata, organization ownership, configuration and lifecycle status.
Isolation
Tenant-scoped by design
Hierarchy
Organizations + sub-organizations
Access
Membership + role context
Configuration
Policies, modules & branding
GET
/v1/tenants/{id}Scope: tenants.readEndpoint summary
| Method | Endpoint | Required scope |
|---|---|---|
| GET | /v1/tenants/{id} | tenants.read |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Tenant identifier |
Example request
GET /v1/tenants/{id}Copy
GET /v1/tenants/{id}
Authorization: Bearer $ACCESS_TOKENExample response
200 OKCopy
{
"id":"tnt_01",
"organization_id":"org_clinic_01",
"tenant_type":"clinic",
"status":"active",
"region":"eu-central"
}Tenant model
| Field | Type | Description |
|---|---|---|
| id | string | Immutable tenant identifier |
| organization_id | string | Owning organization |
| tenant_type | enum | Operational tenant category |
| status | enum | provisioning, active, suspended, archived |
| region | string | Data / hosting region |
| settings | object | Tenant-specific non-secret configuration |