---
title: "List Openrouter Models"
method: GET
path: "/v1/ai-models/openrouter/list"
tags: ["ai-models"]
---

# List Openrouter Models

`GET /v1/ai-models/openrouter/list`

## Query parameters

- `page` integer — Page number (starting from 1)
- `page_size` integer — Number of models per page
- `search` string, nullable — Search by model name, description, or ID

## Response `200`

Successful Response

- OpenRouterModelsList
  - `models` OpenRouterModelDraftResponse[], required
    - `openrouter_id` string, required
    - `name` string, required
    - `model_id` string, required
    - `model_name` string, required
    - `provider` 'openrouter', required
    - `external_model_id` string, required
    - `description` string, required
    - `context_window` integer, required
    - `supports_images` boolean, required
    - `supported_parameters` string[], required
    - `thinking` boolean, required
    - `reasoning_mandatory` boolean, required
    - `reasoning` ModelReasoningConfigInput, required
      - `request_family` 'openrouter'
      - `kind` 'toggle' | 'effort' | 'manual_budget', required
      - `default_effort` string, required
      - `options` ModelReasoningOptionInput[], required
        - `effort` string, required
        - `title` string, required
        - `description` string
      - `mandatory` boolean
      - `supports_max_tokens` boolean
      - `min_tokens` integer, nullable
      - `mode` ModelReasoningModeInput
        - `default_mode` string, required
        - `options` ModelReasoningModeOptionInput[], required
          - `mode` string, required
          - `title` string, required
          - `description` string
          - `external_model_id` string, nullable
          - `provider_mode` string, nullable
    - `is_active` boolean, required
    - `enabled` boolean, required
    - `needs_proxy` boolean, required
    - `status` string, required
    - `sort_order` integer, nullable, required
    - `strength_factor` number, required
    - `multiplier` number, required
    - `pricing` object, required
    - `avg_price` number, required
    - `input_price_per_1m` number, required
    - `output_price_per_1m` number, required
    - `cached_input_price_per_1m` number, nullable, required
    - `temperature` number, nullable
    - `top_p` number, nullable
    - `config` object, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required
  - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kodik/apis/kodik-api.md) · [All operations](https://skmtc.dev/kodik/apis/kodik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kodik/kodik-api/revisions/55c71b347360/schema)