---
title: "Get tenancy configs"
method: GET
path: "/api/v2/integration/oci/tenancies"
tags: ["OCI Integration"]
---

# Get tenancy configs

`GET /api/v2/integration/oci/tenancies`

Get a list of all configured OCI tenancy integrations. Returns basic information about each tenancy including authentication credentials, region settings, and collection preferences for metrics, logs, and resources.

## Response `200`

OK

- TenancyConfigList — Response containing a list of OCI tenancy integration configurations.
  - `data` TenancyConfigData[], required — List of OCI tenancy integration configuration objects.
    - `attributes` TenancyConfigDataAttributes — Attributes of an OCI tenancy integration configuration, including authentication details, region settings, and collection options.
      - `billing_plan_id` integer — The identifier of the billing plan associated with the OCI tenancy.
      - `config_version` integer — Version number of the integration the tenancy is integrated with
      - `cost_collection_enabled` boolean — Whether cost data collection from OCI is enabled for the tenancy.
      - `dd_compartment_id` string — The OCID of the OCI compartment used by the Datadog integration stack.
      - `dd_stack_id` string — The OCID of the OCI Resource Manager stack used by the Datadog integration.
      - `home_region` string — The home region of the OCI tenancy (for example, us-ashburn-1).
      - `logs_config` TenancyConfigDataAttributesLogsConfig — Log collection configuration for an OCI tenancy, indicating which compartments and services have log collection enabled.
        - `compartment_tag_filters` string[] — List of compartment tag filters scoping log collection to specific compartments.
        - `enabled` boolean — Whether log collection is enabled for the tenancy.
        - `enabled_services` string[] — List of OCI service names for which log collection is enabled.
      - `metrics_config` TenancyConfigDataAttributesMetricsConfig — Metrics collection configuration for an OCI tenancy, indicating which compartments and services are included or excluded.
        - `compartment_tag_filters` string[] — List of compartment tag filters scoping metrics collection to specific compartments.
        - `enabled` boolean — Whether metrics collection is enabled for the tenancy.
        - `excluded_services` string[] — List of OCI service names excluded from metrics collection.
      - `parent_tenancy_name` string — The name of the parent OCI tenancy, if applicable.
      - `regions_config` TenancyConfigDataAttributesRegionsConfig — Region configuration for an OCI tenancy, indicating which regions are available, enabled, or disabled for data collection.
        - `available` string[] — List of OCI regions available for data collection in the tenancy.
        - `disabled` string[] — List of OCI regions explicitly disabled for data collection.
        - `enabled` string[] — List of OCI regions enabled for data collection.
      - `resource_collection_enabled` boolean — Whether resource collection from OCI is enabled for the tenancy.
      - `tenancy_name` string — The human-readable name of the OCI tenancy.
      - `user_ocid` string — The OCID of the OCI user used by the Datadog integration for authentication.
    - `id` string — The OCID of the OCI tenancy.
    - `type` 'oci_tenancy', required — OCI tenancy resource type.

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)