API OverviewModels

List public models or fetch a single model

List all available public models. Supports filtering by provider or vendor, or fetching a single model by query parameter with ?model=<provider/model-name>. Results are paginated: a page holds at most 500 models, and larger catalogs are read by following next_cursor until has_more is false.

Authentication

AuthorizationBearer
Your production key sent as a bearer token.

Query parameters

modelstringOptional

Fetch a single model by ID in format ‘provider/model-name’

providerstringOptional
Filter by provider
vendorstringOptional
Filter by vendor
cursorstringOptional

Pagination cursor. Pass the next_cursor returned by the previous page to fetch the models that follow it. Omit on the first request.

limitintegerOptional1-500Defaults to 50

Models per page. Defaults to 50, minimum 1, maximum 500. A limit above 500 is rejected with 422; page through the rest with next_cursor rather than raising it.

Response

Successful Response
PublicModelsListResponseobject

Paginated response wrapper for GET /v1/models. Use the next_cursor field to page through results when has_more is true.

OR
PublicModelobject

A canonical model in Merge Gateway’s catalog. Identified by model (fully-qualified provider/model ID) and exposes the set of vendors that can execute it, each with its own capabilities, context window, pricing, and ZDR flag.

Errors

422
Unprocessable Entity Error