--- title: List Databricks integration accounts description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > Databricks Integration --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # List Databricks integration accounts{% #list-databricks-integration-accounts %} Copy pageCopied {% tab title="v2" %} **Note**: This endpoint is in preview and is subject to change. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). | Datadog site | API endpoint | | ----------------- | ----------------------------------------------------------------------------------- | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/integration-interfaces/databricks/accounts | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/integration-interfaces/databricks/accounts | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/integration-interfaces/databricks/accounts | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/integration-interfaces/databricks/accounts | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/integration-interfaces/databricks/accounts | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/integration-interfaces/databricks/accounts | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/integration-interfaces/databricks/accounts | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/integration-interfaces/databricks/accounts | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/integration-interfaces/databricks/accounts | ### Overview List Databricks integration accounts. This endpoint requires the `integrations_read` permission. ### Response {% tab title="200" %} OK {% tab title="Model" %} Response payload for a list of Databricks integration accounts. | Parent field | Field | Type | Description | | ------------------------------------------------ | ------------------------------------------------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | data [*required*] | [object] | List of Databricks integration accounts. | | data | attributes [*required*] | object | Attributes of a Databricks integration account returned in responses. | | attributes | authentication | | Authentication configured on the Databricks integration account. A `bearer_token` method indicates an account still on token authentication, which Databricks accepts only on accounts that already use it. | | authentication | | object | The Databricks OAuth authentication method and service principal configured on the account. | | | auth_type [*required*] | enum | The authentication method type. Allowed enum values: `databricks_oauth` | | | azure_tenant_id | string | Microsoft Entra ID tenant of the service principal, for Azure Databricks workspaces. | | | client_id [*required*] | string | Client ID of the Databricks service principal. | | authentication | | object | The Private Action Runner authentication method configured on the account. | | | auth_type [*required*] | enum | The authentication method type. Allowed enum values: `private_action_runner` | | | connection_id [*required*] | string | Unique identifier of the Private Action Runner connection holding the credentials. | | | secret_path | string | Path of the credential inside the secret backend configured on the runner. | | | user_uuid [*required*] | string | Unique identifier of the user the Private Action Runner connection belongs to. | | authentication | | object | The bearer token authentication method configured on the account. | | | auth_type [*required*] | enum | The authentication method type. Allowed enum values: `bearer_token` | | attributes | dataflows | object | Data Datadog collects from Databricks, keyed by dataflow id. | | dataflows | databricks-cloud-cost-metrics | object | Cost data collected from your Databricks system tables. Requires [Cloud Cost Management](https://docs.datadoghq.com/cloud_cost_management.md) to be set up for your organization. | | databricks-cloud-cost-metrics | enabled | boolean | Whether Datadog collects this data. | | databricks-cloud-cost-metrics | settings | object | Settings of the Cloud Cost Management dataflow. | | settings | ccm_collect_all_workspaces | boolean | Whether cost data is collected for every workspace in the Databricks account rather than this workspace only. This takes effect across the Databricks account: if any one workspace enables it, Datadog collects cost data for all of them regardless of their individual settings, and every covered workspace incurs Cloud Cost Management charges. | | dataflows | databricks-data-observability-jobs-monitoring | object | Data Jobs Monitoring, which collects performance, reliability, and cost data for your Databricks jobs. | | databricks-data-observability-jobs-monitoring | enabled | boolean | Whether Datadog collects this data. | | databricks-data-observability-jobs-monitoring | settings | object | Settings of the Data Jobs Monitoring dataflow. | | settings | dd_api_key_id | string | ID of the Datadog API key the global init script uses to submit data. | | settings | djm_global_init_script_enabled | boolean | Whether Datadog installs and manages the Agent on your Databricks clusters through a global init script. The script does not apply to clusters in Standard access mode. When `false`, the Agent is installed manually. | | settings | script_gpum_enabled | boolean | Whether GPU metrics are collected from your Databricks clusters. The Agent installed by the global init script performs the collection, so this requires the dataflow to be enabled with `djm_global_init_script_enabled` set to `true`. | | settings | script_logs_enabled | boolean | Whether driver and worker logs are collected from your Databricks clusters. The Agent installed by the global init script performs the collection, so this requires the dataflow to be enabled with `djm_global_init_script_enabled` set to `true`. | | settings | serverless_jobs_enabled | boolean | Whether health and cost data is collected for jobs running on Serverless or SQL Warehouse compute. This compute has no clusters for the global init script to target, so collection reads the Databricks system tables and requires `system_tables_sql_warehouse_id`. | | dataflows | databricks-data-observability-quality-monitoring | object | Data Observability, which collects lineage and data quality information from your Databricks catalogs so you can explore how data flows and detect, resolve, and prevent quality issues. | | databricks-data-observability-quality-monitoring | enabled | boolean | Whether Datadog collects this data. | | databricks-data-observability-quality-monitoring | settings | object | Settings of the Data Observability dataflow. | | settings | do_crawlers_cron | string | Cron expression setting how often Datadog connects to your Databricks warehouse to collect metadata. Currently, only hourly (`0 * * * *`) and daily (`0 0 * * *`) are supported. | | settings | sync_system_catalog | boolean | Whether metadata from the Databricks `system` catalog is included in Data Observability alongside your data catalogs. | | dataflows | databricks-model-serving-metrics | object | Health and usage metrics for your Databricks model serving endpoints. Not supported on accounts that authenticate with `private_action_runner`; on those accounts this dataflow collects no data. | | databricks-model-serving-metrics | enabled | boolean | Whether Datadog collects this data. | | attributes | name [*required*] | string | Human-readable name of the Databricks integration account. | | attributes | settings [*required*] | object | Settings configured on the Databricks integration account. | | settings | system_tables_sql_warehouse_id | string | ID of the SQL warehouse used to query the Databricks system tables. | | settings | workspace_url [*required*] | string | URL of the Databricks workspace. | | data | id [*required*] | string | Server-generated unique identifier of the Databricks integration account. | | data | type [*required*] | enum | The type of the integration account resource. Always `integration-account`. Allowed enum values: `integration-account` | {% /tab %} {% tab title="Example" %} ```json { "data": [ { "attributes": { "authentication": { "auth_type": "databricks_oauth", "azure_tenant_id": "4d3bac44-0230-4732-9e70-cc00736f0a97", "client_id": "5c10654a-b3a3-4840-b37f-f477590c70a0" }, "dataflows": { "databricks-cloud-cost-metrics": { "enabled": true, "settings": { "ccm_collect_all_workspaces": true } }, "databricks-data-observability-jobs-monitoring": { "enabled": true, "settings": { "dd_api_key_id": "fe383f4e-09fc-46bf-8e10-4efdd453a646", "djm_global_init_script_enabled": true, "script_gpum_enabled": true, "script_logs_enabled": true, "serverless_jobs_enabled": true } }, "databricks-data-observability-quality-monitoring": { "enabled": true, "settings": { "do_crawlers_cron": "0 * * * *", "sync_system_catalog": true } }, "databricks-model-serving-metrics": { "enabled": true } }, "name": "My Databricks Workspace", "settings": { "system_tables_sql_warehouse_id": "aba7c023d4172910", "workspace_url": "https://dbc-1234abcd.cloud.databricks.com" } }, "id": "a9a69c2e-4f8d-4e42-9c1a-2a7a2d3b7c6f", "type": "integration-account" } ] } ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Forbidden {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="404" %} Not Found {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/integration-interfaces/databricks/accounts" \ -H "Accept: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" {% /tab %}