AI Gateway

Get an AI Gateway provider

Get a provider by ID, including its routing slug, integration account, and cost multiplier. Credentials stay in the 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.

get/api/v2/providers/{id}

Request

Path parameters

idinteger required

Provider ID.

Response

OK

Example response

{
  "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"
  },
  "included": [
    {
      "attributes": {
        "created_at": "2026-08-24T12:00:00Z",
        "enabled": true,
        "metadata": {
          "limits": {
            "context_window_tokens": 400000,
            "max_output_tokens": 128000
          },
          "modalities": {
            "input": [
              "text"
            ],
            "output": [
              "text"
            ]
          },
          "reasoning": {
            "controls": [
              {
                "effort_levels": [
                  "high"
                ],
                "type": "effort"
              }
            ]
          },
          "reference_pricing": [
            {
              "amount": "2.5",
              "component": "input",
              "context_max_tokens": 272000,
              "currency": "USD",
              "mode": "standard",
              "service_tier": "priority",
              "unit": "million_tokens"
            }
          ],
          "source": {
            "matched_by": "wire_id",
            "model_id": "gpt-5.2-codex",
            "name": "models.dev",
            "provider": "openai"
          },
          "status": "available"
        },
        "model_id_canonical": "gpt-5.2-codex",
        "model_id_wire": "gpt-5.2-codex-20260801",
        "provider_id": 42,
        "source": "discovered",
        "supported_operations": [
          "OPENAI_CHAT_COMPLETIONS"
        ],
        "updated_at": "2026-08-24T12:00:00Z"
      },
      "id": "101",
      "type": "model-catalog-entries"
    }
  ]
}

Changes

Changes to this operation have not been checked yet.