---
title: "List models"
method: GET
path: "/api/v1/models"
tags: ["Models"]
---

# List models

`GET /api/v1/models`

## Request

- Base URL: `https://api.respan.ai`
- URL: `https://api.respan.ai/api/v1/models`
- Auth: one of:
  - none
  - HTTP bearer

Returns the models available through the Respan gateway, in the OpenAI model list format.

Without an API key, the response lists every public model. With an API key, it lists the models your project can use.

## Response `200`

The model list.

- OpenAIModelList
  - `object` 'list', required
  - `data` OpenAIModel[], required
    - `id` string, required: Model ID. Send it as `model` in gateway requests.
    - `object` 'model', required
    - `created` integer, required: Release date as a Unix timestamp, or `0` if unknown.
    - `owned_by` string, required: The organization that develops the model.
    - `context_length` integer, nullable, required: Context window in tokens, or `null` if unknown.
    - `pricing` OpenAIModelPricing, required: Prices in USD.
      - `input_cost` number, nullable, required: Input price per `input_price_unit`. Token and character prices are per 1M.
      - `output_cost` number, nullable, required: Output price per `output_price_unit`. Token and character prices are per 1M.
      - `input_price_unit` 'token' | 'image' | 'second' | 'minute' | 'hour' | 'character', required: Unit for `input_cost`.
      - `output_price_unit` 'token' | 'image' | 'second' | 'minute' | 'hour' | 'character', required: Unit for `output_cost`.

## Changes

- **2026-10-27** `a6ed7ffd176f`: 1 info
  - endpoint added

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

---

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