GET /v1/models

Part of the API reference; this page is generated from the OpenAPI document that the gateway builds from its own route tables.

Provenance

• Contract version: 1.10.0
• Contract title: acumen gateway API
• Source: acumen:docs/openapi/acumen-v1.openapi.json

Operations

GET /v1/models

List the served model catalogue

The OpenAI model list: every canonical model id plus every alias, each with its owning authority (acumen or acumen-alias) and the models-as-truth projection — cost class, measured context window (null when unmeasured) and one provider entry per live, non-retired offer (free/plan flags, prices, cached-read price, tier class, token caps). Reads only; no body. Optional query filters: class, provider, min_ctx, tools, q; optional sort (id|class|price_in|price_out|ctx) and order (asc|desc, default id/asc). An invalid parameter value is 400 schema_invalid.

• Operation id: getV1Models
• Scope: chat
• Exposure: public
• Mutating: no
• Auth: bearerAuth, apiKeyAuth

Responses

• 200: model list
  • application/json: ModelList: ModelList (object)
• 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)