Skip to main content
GET
/
providers
/
{id}
Get an AI Gateway provider
curl --request GET \
  --url https://api.ngrok.ai/providers/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "uri": "<string>",
  "providerId": "<string>",
  "name": "<string>",
  "baseUrl": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "createdBy": {
    "id": "<string>",
    "uri": "<string>"
  },
  "lastUpdatedBy": {
    "id": "<string>",
    "uri": "<string>"
  },
  "metadata": "<string>",
  "supportedApiSurfaces": [
    {
      "format": "<string>",
      "surface": "<string>",
      "supportedParams": [
        {
          "name": "<string>"
        }
      ]
    }
  ],
  "models": [
    {
      "id": "<string>",
      "modelId": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Unique identifier for an AI Gateway provider.

Response

The AI Gateway provider.

id
string
required

Unique identifier for this provider.

uri
string
required

URI of this AI Gateway Provider API resource.

providerId
string
required

Provider identifier used as the address segment in model strings (for example "internal-vllm").

name
string
required

User-friendly label for this provider.

baseUrl
string
required

Base URL of the provider's API endpoint.

createdAt
string<date-time>
required

Timestamp when the provider was created.

updatedAt
string<date-time>
required

Timestamp when the provider was last updated.

createdBy
object
required
lastUpdatedBy
object
required
metadata
string

Arbitrary user-defined metadata for this provider.

supportedApiSurfaces
object[]

API surfaces supported by this provider.

models
object[]

Models exposed by this provider.