---
title: "Retrieve a tenant"
method: GET
path: "/registry/v1/currenttenant"
tags: ["Tenant Registry"]
---

# Retrieve a tenant

`GET /registry/v1/currenttenant`

##### Example request using curl

`curl -X GET {api-url}/registry/v1/currenttenant`
If the user is not logged in then the /definitions/TenantAnonymous is returned
<br />User roles: admin, manager, editor, viewer, authenticatedVisitor, anonymous

## Query parameters

- `fields` string

## Response `200`

Successful response

- object
  - `name` string
  - `id` string — read-only - UUID of the tenant
  - `_id` string, required — DEPRECATED - read-only - UUID of the tenant. Use 'id' instead of _id
  - `locale` string — The locale the UI is shown in
  - `defaultContentLocale` string — The default locale for content
  - `contentLocales` string[] — Array of locales the content can be in
  - `locked` boolean — set to true if the tenant is 'locked' and should not have access to the system
  - `watsonConfidenceLevel` number, double
  - `maxUploadSize` integer — Max upload size - should apply to files/images/audio/video unless useSingleUploadSize is false in which case the individual max uploads apply
  - `useSingleUploadSize` boolean — Use the maxUploadSize to cover all uploads or use the individual max upload sizes
  - `maxUploadSizeFiles` integer — Max upload size for files (if useSingleUploadSize is false)
  - `maxUploadSizeImage` integer — Max upload size for images (if useSingleUploadSize is false)
  - `maxUploadSizeVideo` integer — Max upload size for videos (if useSingleUploadSize is false)
  - `maxAuthors` integer
  - `maxContentItems` integer — Max content items the tenant can have based on plan purchased
  - `maxStorageSize` integer — Max amount of storage the tenant has, based on plan purchased
  - `maxDataTransfer` integer — Max amount of data transfer the tenant has per month, based on plan purchased
  - `isDAMEnabled` boolean
  - `tier` string — The tier of the product the tenant has purchased
  - `ibmUniqueId` string
  - `isEdgeSideEnabled` boolean
  - `maxUserSessions` integer — Max number of User sessions
  - `configDeliveryCacheMaxage` integer — Used when setting Cache-Control max-age response header - value in seconds - can not be negative value
  - `capability` string — indicates the capabilities supported by a tenant
  - `corsWhitelist` string[]
  - `mandatoryAssetPublishApproval` object — Can not be set for Base tiers
    - `enabled` boolean — True if mandatory approval is enabled
    - `exemptAssetTypes` string[]
  - `mandatoryContentPublishApproval` object — Can not be set for Base tiers
    - `enabled` boolean — True if mandatory approval is enabled
    - `exemptContentTypes` string[]
  - `deliveryAccess` object
    - `secureAlways` boolean
    - `content` string
    - `assets` string
  - `ibmCommerce` object
    - `tenantId` string
    - `apiGatewayHost` string
    - `previewSearchHost` string
    - `previewTransactionHost` string
    - `liveSearchHost` string
    - `liveTransactionHost` string
    - `environmentType` string
  - `ibmWca` object — Properties for Campaign integration
  - `edgeToken` string — string to hold edge configuration of the tenant
  - `importZip` object — Information on most recent zip imported

## Other responses

- `400` — Error response
- `404` — Indicates the tenant does not exist
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/versions/677305266d89/schema)