---
title: List AI Gateway providers
description: List the model providers connected to the organization.
breadcrumbs: Docs > API > List AI Gateway providers
---

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

# List AI Gateway providers

## 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/providers     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/providers |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/providers |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/providers      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/providers |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/providers |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/providers |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/providers      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/providers  |

### Overview

List the model providers connected to the organization. Credentials stay in each provider's integration account and are never returned. Requires `ai_gateway_config_read` and provider View. Catalog and pricing metadata inherit provider access. Lists omit hidden entries; direct reads of hidden resources return 404.

This endpoint requires the `ai_gateway_config_read` permission.

OAuth apps require the `ai_gateway_config_read` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#ai-gateway) to access this endpoint.

### Response

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

{% tabs %}
{% tab label="Model" %}
Response containing AI Gateway providers.

| Parent field       | Field                               | Type      | Description                                                                                                                                                                                           |
| ------------------ | ----------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|                    | data [*required*]                   | [object]  |                                                                                                                                                                                                       |
| data               | attributes [*required*]             | object    | AI Gateway provider configuration and metadata.                                                                                                                                                       |
| attributes         | cost_multiplier [*required*]        | double    | Multiplier applied to provider costs.                                                                                                                                                                 |
| attributes         | created_at [*required*]             | date-time | Time when the resource was created.                                                                                                                                                                   |
| attributes         | integration_account_id [*required*] | string    | Provider integration account identifier.                                                                                                                                                              |
| attributes         | integration_config                  | object    | Provider-specific integration configuration.                                                                                                                                                          |
| integration_config | bedrock_region                      | string    | AWS region used for Bedrock model discovery, routing, and request signing.                                                                                                                            |
| integration_config | foundry_project                     | string    | Azure AI Foundry project name, used to call the project's agents.                                                                                                                                     |
| integration_config | foundry_resource_id                 | string    | ARM resource ID of the Azure AI Foundry resource, such as `/subscriptions/<id>/resourceGroups/<group>/providers/Microsoft.CognitiveServices/accounts/<name>`. Required for `azure_foundry` providers. |
| integration_config | location                            | string    | GCP location used for Gemini model discovery and credential resolution.                                                                                                                               |
| integration_config | project_id                          | string    | GCP project ID used for Gemini model discovery and credential resolution.                                                                                                                             |
| integration_config | supported_operations                | [string]  | Custom provider default for discovered and new manual models. Omit to use Chat Completions. An empty list is invalid.                                                                                 |
| attributes         | known_provider [*required*]         | enum      | Known provider implementation. Allowed enum values: `custom`, `anthropic`, `openai`, `azure_openai`, `bedrock`, `gemini`, `baseten`, `fireworks`, `together`, `typesafe`, `azure_foundry`.            |
| attributes         | name [*required*]                   | string    | Human-readable resource name.                                                                                                                                                                         |
| attributes         | slug [*required*]                   | string    | Immutable routing identifier.                                                                                                                                                                         |
| attributes         | updated_at [*required*]             | date-time | Time when the resource was last updated.                                                                                                                                                              |
| data               | id [*required*]                     | string    | Resource identifier.                                                                                                                                                                                  |
| data               | relationships                       | object    | Provider relationships.                                                                                                                                                                               |
| relationships      | models [*required*]                 | object    | Model catalog entries associated with a provider.                                                                                                                                                     |
| models             | data [*required*]                   | [object]  |                                                                                                                                                                                                       |
| data               | id [*required*]                     | string    | Resource identifier.                                                                                                                                                                                  |
| data               | type [*required*]                   | enum      | Model catalog entry resource type. Allowed enum values: `model-catalog-entries`.                                                                                                                      |
| data               | type [*required*]                   | enum      | AI Gateway provider resource type. Allowed enum values: `providers`.                                                                                                                                  |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": [
    {
      "attributes": {
        "cost_multiplier": 1,
        "created_at": "2026-08-24T12:00:00Z",
        "integration_account_id": "account-123",
        "integration_config": {
          "bedrock_region": "us-east-1",
          "foundry_project": "my-project",
          "foundry_resource_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ai/providers/Microsoft.CognitiveServices/accounts/my-foundry",
          "location": "us-central1",
          "project_id": "my-gcp-project",
          "supported_operations": [
            "OPENAI_CHAT_COMPLETIONS"
          ]
        },
        "known_provider": "openai",
        "name": "production-us",
        "slug": "prod-us",
        "updated_at": "2026-08-24T12:00:00Z"
      },
      "id": "42",
      "relationships": {
        "models": {
          "data": [
            {
              "id": "101",
              "type": "model-catalog-entries"
            }
          ]
        }
      },
      "type": "providers"
    }
  ]
}
```
{% /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
# 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/providers" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
```
{% /tab %}
{% /tabs %}
