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

# GET /v1/models

`GET /v1/models`

List available models with optional detailed information including pricing

## Query parameters

- `detailed` boolean
- `sort` 'favorites' | 'mostused'

## Response `200`

List of available 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 — Maximum input tokens (detailed mode only, null if not 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

---

[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-service-production.skmtc.workers.dev/v1/apis/nano-gpt/nanogpt-api/revisions/584e96d146b0/schema)