Skip to Content
API ReferenceProviders API

Providers API

The Providers API lists inference providers and their API configuration, supported regions and confirmed model mappings. For text search, use the Search API.

List Providers

GET /api/providers

List inference providers with pagination, sorted by name.

Query Parameters

ParameterTypeRequiredDefaultDescription
pageintegerNo1Page number (1-indexed)
limitintegerNo20Items per page (max 100)

Example Request

curl "https://api.openmodels.run/api/providers?page=1&limit=10"

Example Response

{ "items": [ { "id": "openai", "name": "OpenAI", "description": "Leading AI research company providing API access to GPT-4, GPT-3.5, DALL-E, and other foundation models through a developer-friendly REST API with global availability.", "api_base_url": "https://api.openai.com/v1", "auth_type": "bearer", "regions": ["us-east-1", "eu-west-1"], "compatibility": "openai", "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-06-15T00:00:00.000Z" }, { "id": "together-ai", "name": "Together AI", "description": "Cloud platform for running and fine-tuning open-source models with high throughput inference and competitive pricing across a wide range of LLMs.", "api_base_url": "https://api.together.xyz/v1", "auth_type": "bearer", "regions": ["us-east-1", "eu-west-1"], "compatibility": "openai", "created_at": "2024-02-01T00:00:00.000Z", "updated_at": "2025-03-10T00:00:00.000Z" } ], "pagination": { "page": 1, "limit": 10, "total": 2, "total_pages": 1 } }

Response Fields

FieldTypeDescription
itemsarrayArray of provider objects
items[].idstringUnique provider identifier (kebab-case)
items[].namestringHuman-readable display name
items[].descriptionstringDetailed description of the provider
items[].api_base_urlstringBase URL for the provider’s API
items[].auth_typestringAuthentication method (bearer, api-key, header)
items[].regionsstring[]Supported deployment regions
items[].compatibilitystringAPI compatibility layer (e.g. openai, anthropic)
items[].created_atstringISO 8601 timestamp when the provider was added
items[].updated_atstringISO 8601 timestamp when the provider was last updated
pagination.pageintegerCurrent page number
pagination.limitintegerItems per page
pagination.totalintegerTotal number of matching providers

Error Responses

StatusTypeDescription
400BAD_REQUESTInvalid query parameters (e.g. limit exceeds 100)

Get Provider

GET /api/providers/:id

Retrieve full details for a single provider by its unique identifier.

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe provider’s unique identifier (e.g. openai, anthropic)

Example Request

curl "https://api.openmodels.run/api/providers/anthropic"

Example Response

{ "id": "anthropic", "name": "Anthropic", "description": "AI safety company providing API access to the Claude family of models, known for helpfulness, harmlessness, and honesty with strong reasoning and analysis capabilities.", "api_base_url": "https://api.anthropic.com/v1", "auth_type": "api-key", "regions": ["us-east-1", "eu-west-1"], "compatibility": "anthropic", "models": [], "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-06-15T00:00:00.000Z" }

Response Fields

FieldTypeDescription
idstringUnique provider identifier (kebab-case)
namestringHuman-readable display name
descriptionstringDetailed description of the provider
api_base_urlstringBase URL for the provider’s API
auth_typestringAuthentication method (bearer, api-key, oauth2, basic, none)
regionsstring[]Supported deployment regions
compatibilitystringAPI compatibility layer (e.g. openai, anthropic)
modelsarrayHosted mappings with model IDs, endpoints, prices and limits; can be empty
created_atstringISO 8601 timestamp when the provider was added
updated_atstringISO 8601 timestamp when the provider was last updated

Error Responses

StatusTypeDescription
404NOT_FOUNDProvider with the given ID does not exist