---
title: "Read the reviewed inference model contract"
method: GET
path: "/credits/models/{provider}"
tags: ["Catalog"]
---

# Read the reviewed inference model contract

`GET /credits/models/{provider}`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/models/{provider}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns Locus-supported model IDs, exact pricing dimensions, limits, route capabilities, request-field compatibility, deprecation state, and freshness metadata. This is a reviewed support boundary, not a pass-through of the provider's account-scoped model list.

## Path parameters

- `provider` string, required

## Headers

- `If-None-Match` string

## Response `200`

Versioned inference model contract

- ModelCatalogResponse
  - `success` unknown, required
  - `catalog` InferenceModelCatalog, required
    - `schemaVersion` '2026-08-01', required
    - `pricingVersion` string, required
    - `provider` string, required
    - `publishedAt` string, date-time, required
    - `freshness` object, required
      - `maxAgeSeconds` integer, required
      - `staleAfter` string, date-time, required
      - `source` 'locus-reviewed-static', required
    - `models` InferenceModelMetadata[], required
      - `id` string, required
      - `status` 'active' | 'deprecated', required
      - `deprecationDate` string, date, nullable, required
      - `contextWindowTokens` integer, required
      - `providerMaxOutputTokens` integer, required
      - `locusMaxOutputTokens` integer, required
      - `recommendedMinOutputTokens` integer, required
      - `pricing` object, required
        - `unit` 'usd_per_1m_tokens', required
        - `input` string, required
        - `output` string, required
      - `capabilities` InferenceModelCapabilities, required
        - `text` boolean, required
        - `vision` boolean, required
        - `tools` boolean, required
        - `json` boolean, required
        - `streaming` boolean, required: Capability of the current Locus credits route, not only the upstream model.
        - `reasoning` boolean, required
      - `request` object, required
        - `outputTokenField` 'max_tokens' | 'max_completion_tokens', required
        - `incompatibleFields` string[], required

## Other responses

- `304`: Catalog is unchanged for the supplied If-None-Match value.
- `404`: No reviewed model catalog exists for this provider.

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)