---
title: Get a ChatGPT Enterprise integration account
description: Get a ChatGPT Enterprise integration account.
breadcrumbs: Docs > API > Get a ChatGPT Enterprise integration account
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Get a ChatGPT Enterprise integration account

## v2 (latest)

{% alert level="warning" %}
**Note**: This endpoint is in Preview and is subject to change.
If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help.md).
{% /alert %}

| Datadog site      | API endpoint                                                                                             |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id}      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id}  |

### Overview

Get a ChatGPT Enterprise integration account.

This endpoint requires the `integrations_read` permission.

### Arguments

#### Path Parameters

| Field                   | Type   | Description                                   |
| ----------------------- | ------ | --------------------------------------------- |
| account_id [*required*] | string | Unique identifier of the integration account. |

### Response

{% tabs %}
{% tab label="200" %}
OK

{% tabs %}
{% tab label="Model" %}
Response payload for a single ChatGPT Enterprise integration account.

| Parent field                       | Field                              | Type      | Description                                                                                                                                                                                                                                                                                      |
| ---------------------------------- | ---------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|                                    | data [*required*]                  | object    | Data envelope of a ChatGPT Enterprise integration account, including server-assigned identity.                                                                                                                                                                                                   |
| data                               | attributes [*required*]            | object    | Attributes of a ChatGPT Enterprise integration account returned in responses.                                                                                                                                                                                                                    |
| attributes                         | authentication                     | <oneOf>   | Authentication configured on the ChatGPT Enterprise integration account.                                                                                                                                                                                                                         |
| authentication                     | <auth_type=bearer_token>           | object    | The bearer token authentication method configured on the account.                                                                                                                                                                                                                                |
| <auth_type=bearer_token>           | auth_type [*required*]             | enum      | The authentication method type. Allowed enum values: `bearer_token`. Default: `bearer_token`.                                                                                                                                                                                                    |
| attributes                         | dataflows                          | object    | Data Datadog collects from ChatGPT Enterprise, keyed by dataflow ID.                                                                                                                                                                                                                             |
| dataflows                          | chatgpt-enterprise-agent-console   | object    | Activity, token consumption, credits, and estimated usage costs across ChatGPT Chat, ChatGPT Work, and Codex, shown in Agent Console with breakdowns by product, model, and user where OpenAI provides them.                                                                                     |
| chatgpt-enterprise-agent-console   | enabled                            | boolean   | Whether Datadog collects this data.                                                                                                                                                                                                                                                              |
| chatgpt-enterprise-agent-console   | status                             | object    | Read-only collection status of a dataflow. Read-only.                                                                                                                                                                                                                                            |
| status                             | health                             | enum      | Collection health of a single dataflow. Allowed enum values: `DATAFLOW_HEALTH_OK`, `DATAFLOW_HEALTH_BROKEN`, `DATAFLOW_HEALTH_UNKNOWN`.                                                                                                                                                          |
| status                             | message                            | string    | Human-readable detail, populated when the dataflow is not healthy.                                                                                                                                                                                                                               |
| status                             | updated_at                         | date-time | Time the status was last computed.                                                                                                                                                                                                                                                               |
| dataflows                          | chatgpt-enterprise-cloud-cost-data | object    | ChatGPT Enterprise costs from the OpenAI Costs API, which you can analyze in [Cloud Cost Management](https://docs.datadoghq.com/cloud_cost_management.md). These costs are excluded from Cloud Cost Management spend-monitored billing. Reported costs are estimates, not final invoice amounts. |
| chatgpt-enterprise-cloud-cost-data | enabled                            | boolean   | Whether Datadog collects this data.                                                                                                                                                                                                                                                              |
| chatgpt-enterprise-cloud-cost-data | status                             | object    | Read-only collection status of a dataflow. Read-only.                                                                                                                                                                                                                                            |
| status                             | health                             | enum      | Collection health of a single dataflow. Allowed enum values: `DATAFLOW_HEALTH_OK`, `DATAFLOW_HEALTH_BROKEN`, `DATAFLOW_HEALTH_UNKNOWN`.                                                                                                                                                          |
| status                             | message                            | string    | Human-readable detail, populated when the dataflow is not healthy.                                                                                                                                                                                                                               |
| status                             | updated_at                         | date-time | Time the status was last computed.                                                                                                                                                                                                                                                               |
| attributes                         | name [*required*]                  | string    | Human-readable name of the ChatGPT Enterprise integration account.                                                                                                                                                                                                                               |
| attributes                         | settings [*required*]              | object    | Settings configured on the ChatGPT Enterprise integration account.                                                                                                                                                                                                                               |
| settings                           | openai_org_id [*required*]         | string    | OpenAI API Platform organization ID (`org-...`) that the Costs API uses for your Enterprise usage. This is not the ChatGPT workspace UUID or your Datadog organization ID. A value that does not match `^org-[A-Za-z0-9]+$` is rejected with a `422` response.                                   |
| data                               | id [*required*]                    | string    | Server-generated unique identifier of the ChatGPT Enterprise integration account. Read-only.                                                                                                                                                                                                     |
| data                               | type [*required*]                  | enum      | The type of the integration account resource. Always `integration-account`. Allowed enum values: `integration-account`. Default: `integration-account`.                                                                                                                                          |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "bearer_token"
      },
      "dataflows": {
        "chatgpt-enterprise-agent-console": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "chatgpt-enterprise-cloud-cost-data": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        }
      },
      "name": "chatgpt-enterprise-acme",
      "settings": {
        "openai_org_id": "org-AbC123dEf456"
      }
    },
    "id": "3e8a1f6b-9c2d-4b7e-8a5f-6d1c4e9b2a03",
    "type": "integration-account"
  }
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="400" %}
Bad Request

{% tabs %}
{% tab label="Model" %}
API error response.

| Parent field | Field               | Type     | Description                                                                     |
| ------------ | ------------------- | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | code                | string   | An application-specific error code.                                             |
| errors       | detail              | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                | object   | Non-standard meta-information about the error                                   |
| errors       | source              | object   | References to the source of the error.                                          |
| source       | header              | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter           | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer             | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status              | string   | Status code of the response.                                                    |
| errors       | title               | string   | Short human-readable summary of the error.                                      |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    {
      "code": "invalid_request",
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="403" %}
Forbidden

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="404" %}
Not Found

{% tabs %}
{% tab label="Model" %}
API error response.

| Parent field | Field               | Type     | Description                                                                     |
| ------------ | ------------------- | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | code                | string   | An application-specific error code.                                             |
| errors       | detail              | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                | object   | Non-standard meta-information about the error                                   |
| errors       | source              | object   | References to the source of the error.                                          |
| source       | header              | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter           | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer             | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status              | string   | Status code of the response.                                                    |
| errors       | title               | string   | Short human-readable summary of the error.                                      |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    {
      "code": "invalid_request",
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="429" %}
Too many requests

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}
{% /tabs %}

### Code Example

{% tabs %}
{% tab label="Curl" %}
```bash
# Path parameters
export account_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/integration-interfaces/chatgpt-enterprise/accounts/${account_id}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
```
{% /tab %}
{% /tabs %}
