---
title: Get all connected Salesforce organizations
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Salesforce Integration
---

# Get all connected Salesforce organizations{% #get-all-connected-salesforce-organizations %}
Copy pageCopied
{% tab title="v2" %}

| Datadog site      | API endpoint                                                                            |
| ----------------- | --------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/integration/salesforce-incidents/organizations |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/integration/salesforce-incidents/organizations |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/integration/salesforce-incidents/organizations      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/integration/salesforce-incidents/organizations      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/integration/salesforce-incidents/organizations  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/integration/salesforce-incidents/organizations     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/integration/salesforce-incidents/organizations |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/integration/salesforce-incidents/organizations |

### Overview

Get all Salesforce organizations connected to your Datadog organization through the Salesforce integration. Salesforce organizations are connected through the OAuth setup flow in the Datadog Salesforce integration page. This endpoint requires the `integrations_read` permission.

### Response

{% tab title="200" %}
OK
{% tab title="Model" %}
Response containing a list of Salesforce organizations connected to the Datadog Salesforce integration.

| Parent field | Field                        | Type     | Description                                                                              |
| ------------ | ---------------------------- | -------- | ---------------------------------------------------------------------------------------- |
|              | data [*required*]       | [object] | An array of Salesforce organizations.                                                    |
| data         | attributes [*required*] | object   | Attributes of a Salesforce organization connected to the Datadog Salesforce integration. |
| attributes   | instance_url                 | string   | The Salesforce instance URL used to call this organization's APIs.                       |
| attributes   | name                         | string   | Human-readable name of the Salesforce organization.                                      |
| attributes   | sfdc_org_id                  | string   | The Salesforce organization identifier (15- or 18-character Salesforce org ID).          |
| attributes   | sfdc_org_type                | string   | The Salesforce organization type (for example, `Production` or `Sandbox`).               |
| data         | id [*required*]         | string   | The Datadog-assigned ID of the connected Salesforce organization.                        |
| data         | type [*required*]       | enum     | Salesforce organization resource type. Allowed enum values: `salesforce-incidents-org`   |

{% /tab %}

{% tab title="Example" %}

```json
{
  "data": [
    {
      "attributes": {
        "instance_url": "https://acme.my.salesforce.com",
        "name": "Acme Production Org",
        "sfdc_org_id": "00D000000000000",
        "sfdc_org_type": "Production"
      },
      "id": "596da4af-0563-4097-90ff-07230c3f9db3",
      "type": "salesforce-incidents-org"
    }
  ]
}
```

{% /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/salesforce-incidents/organizations" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" 
                
{% /tab %}