---
title: "Search the current model catalog"
method: GET
path: "/api/v1/models"
tags: ["Models"]
---

# Search the current model catalog

`GET /api/v1/models`

## Request

- Base URL: `https://cheapestllmapi.com`
- URL: `https://cheapestllmapi.com/api/v1/models`
- Auth: none required

Find canonical model slugs, context limits, and provider prices. Optional provider_slug filters availability, not the provider in bestOffer. bestOffer is selected for 10M input + 2M output tokens; use offer_compare for your workload. Follow pagination.hasMore.

## Query parameters

- `q` string
- `provider` string
- `category` string
- `page` integer
- `page_size` integer

## Response `200`

A page of matching model records

- object
  - `meta` object, required
    - `apiVersion` 'v1', required
    - `currency` 'USD', required
    - `tokenPriceUnit` 'per_million_tokens', required
  - `data` object, required
    - `models` object[], required
      - `id` string, required
      - `slug` string, required
      - `name` string, required
      - `author` object, required
        - `slug` string, required
        - `name` string, required
      - `family` string, nullable, required
      - `releasedAt` string, date, nullable, required
      - `contextTokens` integer, nullable, required
      - `maxOutputTokens` integer, nullable, required
      - `weightAvailability` 'closed' | 'open' | 'unknown', required
      - `offerCount` integer, required
      - `bestOffer` object, nullable, required: Provider selected using 10 million input and 2 million output tokens; not independent minima or a quote for every workload.
        - `provider` object, required
          - `slug` string, required
          - `name` string, required
        - `prices` object, required
          - `inputPerMillionTokens` number, required
          - `outputPerMillionTokens` number, required
  - `pagination` object, required
    - `total` integer
    - `hasMore` boolean
    - `page` integer
    - `pageSize` integer
    - `pageCount` integer
    - `offset` integer
    - `limit` integer

## Other responses

- `400`: Invalid request, missing resource, or temporary catalog failure
- `429`: Invalid request, missing resource, or temporary catalog failure
- `503`: Invalid request, missing resource, or temporary catalog failure

---

[API](https://skmtc.dev/cheapestllmapi/apis/cheapest-llm-api-public-data-api.md) · [All operations](https://skmtc.dev/cheapestllmapi/apis/cheapest-llm-api-public-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cheapestllmapi/apis/cheapest-llm-api-public-data-api/revisions/81b9a3301c5c?raw)