---
title: "Retrieve Tenant for current Org"
method: GET
path: "/v2/org/{org}/nico/tenant/current"
tags: ["Tenant"]
---

# Retrieve Tenant for current Org

`GET /v2/org/{org}/nico/tenant/current`

Retrieve Tenant entity for current Org.

`capabilities.targetedInstanceCreation` is a deprecated read-only aggregate: it is `true` when all Ready Tenant Account for this Tenant has TargetedInstanceCreation enabled in its configuration to preserve backwards compatibility. Configure the capability per Provider/per Site via PATCH `/tenant/account/{accountId}` using `siteCapabilities`. Disallowing at Provider or Site level would result in no value returned here.

User must have authorization role with `TENANT_ADMIN` suffix.

## Response `200`

OK

- Tenant — Tenant is the consumer of resources that Infrastructure Providers serve
  - `id` string, uuid — Unique ID of the Tenant
  - `org` string — Name/external ID of Tenant's organization
  - `orgDisplayName` string, nullable — Display name of Tenant's organization
  - `created` string, date-time — Date/time the Tenant was created
  - `updated` string, date-time — Date/time when Tenant was last updated
  - `capabilities` TenantCapabilities — Deprecated tenant-wide capability summary. TargetedInstanceCreation is no longer stored on the Tenant entity; it is configured on Tenant Account `siteCapabilities` (and may be overridden per Site via Tenant Site configuration). On GET `/tenant/current`, `targetedInstanceCreation` is present and `true` only when the Tenant has at least one Ready Tenant Account, every Ready Tenant Account has the capability enabled by default, and no Tenant Site explicitly disables it. Otherwise the property is omitted. Embedded `TenantSummary.capabilities` objects in nested resources also omit the property.
    - `targetedInstanceCreation` boolean — Deprecated in favor of TenantAccount.siteCapabilities. On GET `/tenant/current`, the property is present and true only when every Ready Tenant Account enables TargetedInstanceCreation and no Tenant Site explicitly disables it; otherwise it is omitted. It is also omitted from embedded TenantSummary objects.
  - `deprecations` Deprecation[] — Deprecation notices for Tenant fields
    - `attribute` string, nullable — Name of the attribute that is deprecated. Omitted if queryParam or endpoint is being deprecated.
    - `queryParam` string, nullable — Query parameter that is deprecated. Omitted if attribute or endpoint is being deprecated.
    - `endpoint` string, nullable — API endpoint that is deprecated. Omitted if attribute or queryParam is being deprecated.
    - `replacedBy` string, nullable — Name of the attribute, query parameter, or endpoint that replaces the deprecated item. Omitted if no replacement is available.
    - `takeActionBy` string, date-time — Date/time by which clients should migrate away from the deprecated API surface
    - `notice` string — Message describing the deprecation

## Other responses

- `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects

## Changes

- **2026-07-30** `dfd4cab0a8b1` — 1 breaking, 2 info
  - the `capabilities/targetedInstanceCreation` response's property type/format changed from `boolean`/`uuid` to `boolean`/`` for status `200`
  - added the optional property `deprecations` to the response with the `200` status
  - response property `capabilities/targetedInstanceCreation` deprecated

[Change history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/tenant/current/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api.md) · [All operations](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-infra-controller-rest-api/revisions/2d6cc0ee8a4a/schema)