---
title: "List the decision models you can use"
method: GET
path: "/api/v1/decision-models"
tags: ["AI"]
---

# List the decision models you can use

`GET /api/v1/decision-models`

## Request

- Base URL: `https://your-deployment.example.com`
- URL: `https://your-deployment.example.com/api/v1/decision-models`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Returns the decision models you can call right now, with their per-model caps and USD token prices. A model is listed only when a key for its provider is available to you (your own provider key or one the deployment configures), so the list can differ between callers and grows when a key is added. A floating alias carries `alias_of`; pin the versioned id when you tune thresholds, since a new version can shift probabilities. The catalog is a handful of entries, so it is returned whole, not paginated (as `GET /api/v1/video-models`).

## Response `200`

The models you can call.

- ListDecisionModelsResponse200
  - `models` object[], required
    - `id` string, required
    - `object` 'decision_model', required
    - `display_name` string, required
    - `provider` string, required
    - `alias_of` string, nullable, required: Set on a floating alias; pin the versioned id to keep thresholds stable.
    - `supports_images` boolean, required
    - `limits` object, required
      - `max_questions` integer, required
      - `max_choices` integer, required
      - `max_levels` integer, required
      - `max_images` integer, required
      - `max_input_tokens` integer, required
    - `pricing` object, required
      - `usd_per_million_input_tokens` number, required
      - `usd_per_million_output_tokens` number, required

## Other responses

- `401`: Missing or invalid credentials.
- `403`: The API key holds neither `ai:decide` nor `ai:generate`.
- `405`: The path does not serve this HTTP method.
- `429`: Per-key or per-user decisions rate limit exceeded.

---

[API](https://skmtc.dev/bike4mind/apis/bike4mind-api.md) · [All operations](https://skmtc.dev/bike4mind/apis/bike4mind-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bike4mind/apis/bike4mind-api/revisions/db47495b892f?raw)