---
title: "GET /v1/decision-models"
method: GET
path: "/v1/decision-models"
---

# GET /v1/decision-models

`GET /v1/decision-models`

## Request

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

List decision models, with pricing, `decision_input` and `supported_endpoints`. Same as `GET /v1/models?output_modalities=decisions`, except entries are detailed by default; pass `detailed=false` for IDs only.

## Query parameters

- `detailed` boolean

## Response `200`

List of available decision models

- ModelsResponse
  - `object` string: Type of object, always 'list' for the models response
  - `data` object[]: List of available models
    - `id` string: Unique identifier for the model
    - `object` string: Type of object, always 'model'
    - `created` integer: Unix timestamp when the model was created
    - `owned_by` string: Organization that owns the model
    - `name` string: Human-readable model name (detailed mode only)
    - `description` string: Detailed model description (detailed mode only)
    - `context_length` integer, nullable: Total context window shared by input and generated output (detailed mode only, null if not available)
    - `max_output_tokens` integer, nullable: Maximum generated output tokens (detailed mode only, null if no serving-route limit is known)
    - `capabilities` object: Model capability flags such as vision, reasoning, tool calling, structured output, PDF upload, video input, and Batch API support (detailed mode only)
    - `supported_service_tiers` string[]: Alternate service tiers accepted by the model (detailed mode only). Fast is the preferred public spelling for higher-priority OpenAI processing; priority remains accepted as a legacy alias. An empty array means only the default service tier is available.
    - `pricing` object: Pricing information object (detailed mode only)
      - `prompt` number: Cost per million input tokens in USD
      - `completion` number: Cost per million output tokens in USD
      - `currency` string: Always 'USD'
      - `unit` string: Always 'per_million_tokens'
    - `distillationPolicy` DistillationPolicy: API-only policy metadata indicating whether model or provider-route outputs may be used for model training, fine-tuning, distillation, or similar model-improvement workflows under NanoGPT's recorded model-license and provider-terms rules.
      - `status` 'allowed' | 'disallowed' | 'unknown': Whether distillation is allowed under the current recorded rule set.
      - `label` string: Human-readable policy summary.
      - `basis` 'deepseek-api-terms' | 'permissive-open-weights' | 'provider-output-use-terms' | 'provider-output-use-restriction' | 'closed-provider-restriction' | 'provider-terms-unknown': Rule basis used to derive the policy status.
      - `sourceUrl` string, uri: License or provider terms URL used as the policy source, when recorded.
      - `note` string: Short explanation and caveats for the policy signal.

## Other responses

- `400`: Unexpected error

## Changes

- **2026-11-03** `cc8b07d75689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nano-gpt/apis/nanogpt-api/changes/v1/decision-models/get.md)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)