--- title: List entity context sync configurations description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > Security Monitoring --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # List entity context sync configurations{% #list-entity-context-sync-configurations %} 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/security_monitoring/configuration/integration_config | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/security_monitoring/configuration/integration_config | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/security_monitoring/configuration/integration_config | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/security_monitoring/configuration/integration_config | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/security_monitoring/configuration/integration_config | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/security_monitoring/configuration/integration_config | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/security_monitoring/configuration/integration_config | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/security_monitoring/configuration/integration_config | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/security_monitoring/configuration/integration_config | ### Overview List the entity context sync configurations for Cloud SIEM. Each configuration connects Cloud SIEM to an external source that provides entities (for example, users from an identity provider) for use in signals and the entity explorer. This endpoint requires the `integrations_read` permission. OAuth apps require the `integrations_read` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#security-monitoring) to access this endpoint. ### Arguments #### Query Strings | Name | Type | Description | | ------------------------ | ---- | --------------------------------------------------------------------------------------------------------------------- | | filter[integration_type] | enum | Filter the entity context sync configurations by source type. Allowed enum values: `GOOGLE_WORKSPACE, OKTA, ENTRA_ID` | ### Response {% tab title="200" %} OK {% tab title="Model" %} Response containing a list of entity context sync configurations. | Parent field | Field | Type | Description | | ------------ | ---------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------- | | | data [*required*] | [object] | The list of integration configurations. | | data | attributes [*required*] | object | The attributes of an entity context sync configuration as returned by the API. | | attributes | created_at | date-time | The time at which the entity context sync configuration was created. | | attributes | domain [*required*] | string | The domain associated with the external entity source (for example, the customer's identity provider domain). | | attributes | enabled [*required*] | boolean | Whether the sync is enabled and actively ingesting entities into Cloud SIEM. | | attributes | integration_type [*required*] | enum | The type of external source that provides entities to Cloud SIEM. Allowed enum values: `GOOGLE_WORKSPACE,OKTA,ENTRA_ID` | | attributes | modified_at | date-time | The time at which the entity context sync configuration was last modified. | | attributes | name | string | The display name of the entity context sync configuration. | | attributes | settings | object | Free-form, non-sensitive settings for the entity context sync. The accepted keys depend on the source type. | | attributes | state | enum | The state of the credentials configured on the entity context sync. Allowed enum values: `valid,invalid,initializing` | | data | id [*required*] | string | The unique identifier of the integration configuration. | | data | type [*required*] | enum | The type of the resource. The value should always be `integration_config`. Allowed enum values: `integration_config` | {% /tab %} {% tab title="Example" %} ```json { "data": [ { "attributes": { "created_at": "2026-05-01T12:00:00Z", "domain": "siem-test.com", "enabled": true, "integration_type": "GOOGLE_WORKSPACE", "modified_at": "2026-05-01T12:00:00Z", "name": "My GWS Integration", "settings": { "setting1": "value1" }, "state": "valid" }, "id": "11111111-2222-3333-4444-555555555555", "type": "integration_config" } ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Not Authorized {% 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/security_monitoring/configuration/integration_config" \ -H "Accept: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" ##### ```python """ List entity context sync configurations returns "OK" response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.security_monitoring_api import SecurityMonitoringApi configuration = Configuration() configuration.unstable_operations["list_security_monitoring_integration_configs"] = True with ApiClient(configuration) as api_client: api_instance = SecurityMonitoringApi(api_client) response = api_instance.list_security_monitoring_integration_configs() print(response) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python3 "example.py" ##### ```ruby # List entity context sync configurations returns "OK" response require "datadog_api_client" DatadogAPIClient.configure do |config| config.unstable_operations["v2.list_security_monitoring_integration_configs".to_sym] = true end api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new p api_instance.list_security_monitoring_integration_configs() ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```go // List entity context sync configurations returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() configuration.SetUnstableOperationEnabled("v2.ListSecurityMonitoringIntegrationConfigs", true) apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewSecurityMonitoringApi(apiClient) resp, r, err := api.ListSecurityMonitoringIntegrationConfigs(ctx, *datadogV2.NewListSecurityMonitoringIntegrationConfigsOptionalParameters()) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SecurityMonitoringApi.ListSecurityMonitoringIntegrationConfigs`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `SecurityMonitoringApi.ListSecurityMonitoringIntegrationConfigs`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" go run "main.go" ##### ```java // List entity context sync configurations returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.SecurityMonitoringApi; import com.datadog.api.client.v2.model.SecurityMonitoringIntegrationConfigsResponse; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setUnstableOperationEnabled("v2.listSecurityMonitoringIntegrationConfigs", true); SecurityMonitoringApi apiInstance = new SecurityMonitoringApi(defaultClient); try { SecurityMonitoringIntegrationConfigsResponse result = apiInstance.listSecurityMonitoringIntegrationConfigs(); System.out.println(result); } catch (ApiException e) { System.err.println( "Exception when calling SecurityMonitoringApi#listSecurityMonitoringIntegrationConfigs"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" java "Example.java" ##### ```rust // List entity context sync configurations returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_security_monitoring::ListSecurityMonitoringIntegrationConfigsOptionalParams; use datadog_api_client::datadogV2::api_security_monitoring::SecurityMonitoringAPI; #[tokio::main] async fn main() { let mut configuration = datadog::Configuration::new(); configuration .set_unstable_operation_enabled("v2.ListSecurityMonitoringIntegrationConfigs", true); let api = SecurityMonitoringAPI::with_config(configuration); let resp = api .list_security_monitoring_integration_configs( ListSecurityMonitoringIntegrationConfigsOptionalParams::default(), ) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * List entity context sync configurations returns "OK" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); configuration.unstableOperations[ "v2.listSecurityMonitoringIntegrationConfigs" ] = true; const apiInstance = new v2.SecurityMonitoringApi(configuration); apiInstance .listSecurityMonitoringIntegrationConfigs() .then((data: v2.SecurityMonitoringIntegrationConfigsResponse) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" tsc "example.ts" {% /tab %}