---
title: "Get a Tenant"
method: GET
path: "/tenants/{tenant_id}"
tags: ["Tenants"]
---

# Get a Tenant

`GET /tenants/{tenant_id}`

Returns one tenant with its name, parent tenant id, default preferences, properties, and the user profile applied to its members.

## Path parameters

- `tenant_id` string, required

## Response `200`

- Tenant
  - `id` string, required — Id of the tenant.
  - `name` string, required — Name of the tenant.
  - `parent_tenant_id` string, nullable — Tenant's parent id (if any).
  - `default_preferences` DefaultPreferences
    - `items` SubscriptionTopic[], nullable
      - `status` 'OPTED_OUT' | 'OPTED_IN' | 'REQUIRED', required
      - `has_custom_routing` boolean, nullable — Override channel routing with custom preferences. This will override any template preferences that are set, but a user can still customize their preferences
      - `custom_routing` ChannelClassification[], nullable — The default channels to send to this tenant when has_custom_routing is enabled
  - `properties` object, nullable — Arbitrary properties accessible to a template.
  - `user_profile` object, nullable — A user profile object merged with user profile on send.
  - `brand_id` string, nullable — Brand to be used for the account when one is not specified by the send call.

## Other responses

- `400`

---

[API](https://skmtc.net/trycourier/apis/courier.md) · [All operations](https://skmtc.net/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycourier/courier/versions/04f69fbf96a5/schema)