Model list

This page documents the GET /v1/models operation that returns the model catalogue. The live list served by the gateway is authoritative — the contract captured here was generated at build time and cannot reflect changes the gateway makes to its model registry between builds.

Provenance

• Contract version: 1.10.0
• Contract title: acumen gateway API
• Source: acumen:docs/openapi/acumen-v1.openapi.json
• Generated at: 2026-11-06T06:53:15.941Z

GET /v1/models

List the served model catalogue

Auth: bearerAuth, apiKeyAuth.

Query parameters

Parameter	Type	Required	Description
class	string	no	keep only models of this cost class
provider	string	no	keep only models with a live offer from this provider id
min_ctx	integer	no	keep only models whose measured context window is at least n (unmeasured never matches)
tools	string	no	when true, keep only models with a probed tools-capable seat
q	string	no	case-insensitive substring filter on the model id
sort	string	no	sort key
order	string	no	sort direction (default asc)

Response

• 200: model list
  • application/json: ModelList: ModelList (object)

ModelList properties:

Field	Type	Required	Notes
data	array of Model (object)	yes
object	string	yes

Model fields:

Field	Type	Required	Notes
class	string	no
created	integer	yes
ctx	`integer	null`	no
id	string	yes
object	string	yes
owned_by	string	yes
providers	array	no

Provider entry fields:

Field	Type	Required	Notes
caps	`object	null`	yes
free	boolean	yes
max_out	integer	no
plan_covered	boolean	yes
price_in	number	yes
price_in_cached	`number	null`	no
price_out	number	yes
provider_id	string	yes
quant	string	no
source	string	no
tier_class	string	yes
vendor_model	string	yes

• 400: schema_invalid — an invalid query parameter value
  • application/json: OpenAIError: OpenAIError (object)
• 401: invalid_api_key — the model plane answers in the OpenAI error envelope
  • application/json: OpenAIError: OpenAIError (object)