---
title: "List live models"
method: GET
path: "/models"
---

# List live models

`GET /models`

## Request

- Base URL: `https://www.ninjachat.ai/api/v1`
- URL: `https://www.ninjachat.ai/api/v1/models`
- Auth: none required

## Response `200`

Runtime catalog data, capabilities, provider rails, availability, and prices.

- ModelListResponse
  - `object` 'list', required
  - `data` PublicModel[], required
    - `object` 'model', required
    - `created` integer, required
    - `owned_by` string, required
    - `id` string, required
    - `name` string, required
    - `modality` 'text' | 'image' | 'image_edit' | 'video' | 'audio' | 'embedding' | 'rerank' | 'search', required
    - `status` 'preview' | 'ga' | 'deprecated' | 'retired', required
    - `servable` boolean, required
    - `description` string
    - `capabilities` string[], required
    - `contextWindow` number
    - `maxOutputTokens` number
    - `pricing` object, required
      - `unit` 'token' | 'image' | 'second' | 'request' | 'character', required
      - `typicalRequestUsd` number
      - `meteredPromptPerToken` number
      - `meteredCachedPromptPerToken` number
      - `meteredCacheWritePromptPerToken` number
      - `meteredCompletionPerToken` number
      - `perRequestUsd` number
      - `perUnitUsd` number
      - `listPerUnitUsd` number
      - `promotion` object
        - `label` string, required
        - `discountPercent` number, required
        - `startsAt` string, date-time, required
        - `endsAt` string, date-time, required
    - `providers` object[], required
      - `provider` string, required
      - `providerDisplayName` string, required
      - `upstreamModelId` string, required
      - `role` 'primary' | 'fallback' | 'emergency', required
      - `available` boolean, required
      - `unsupportedCapabilities` string[]
      - `trainsOnData` boolean
      - `zeroRetentionAvailable` boolean
      - `contextWindow` number
      - `maxOutputTokens` number
      - `performance` object, nullable
        - `samples` integer, required
        - `successRate` number, nullable, required
        - `p50Ms` number, nullable, required
        - `p95Ms` number, nullable, required
        - `medianTtftMs` number, nullable, required
        - `thin` boolean, required
    - `supportedParameters` string[], required
    - `brand` string, required
    - `virtual` boolean
    - `pricingNote` string
    - `overlay` object
      - `isOverlay` boolean, required
      - `dispatch` 'live' | 'pending', required
      - `overrideStatus` string
    - `history` object[]
  - `total` integer, required
  - `generated_at` string, date-time, required

---

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