---
title: "Preview what each model tier resolves to per harness provider"
method: GET
path: "/api/models-catalog/tiers"
tags: ["Pricing"]
---

# Preview what each model tier resolves to per harness provider

`GET /api/models-catalog/tiers`

One row per provider and tier: the built-in default, the `MODEL_TIER_<PROVIDER>_<TIER>` value stored in swarm config (if any), which layer wins, and the concrete model it resolves to against the current catalog (`latest:` aliases resolved with the same soak and auto-upgrade rules as claim time, without recording a resolution). Ignores per-worker `MODEL_TIER_*` overrides and per-task models.

## Response `200`

Tier previews

- object
  - `tiers` object[], required
    - `provider` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh', required
    - `tier` 'smol' | 'regular' | 'smart' | 'ultra', required
    - `key` string, required
    - `defaultValue` string, required
    - `configured` string, nullable, required
    - `source` 'tier-config' | 'tier-default', required
    - `resolvedModel` string, nullable, required
    - `alias` string, nullable, required

## Changes

- **2026-09-30** `e248ce78b701` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/models-catalog/tiers/get.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/78f58e6d81be?raw)