# OpenRouter API: List models

> Lists public OpenRouter models with per-million-token prices, context size, input types, release date and model page. Results can be sorted by newest, input price or popularity.

Unofficial. Not affiliated with or endorsed by OpenRouter.

- Page: https://fous.com/methods/openrouter.ai/list-models
- Method: `openrouter.ai/list_models`, version 1
- Website: openrouter.ai
- Returns: model name, provider, input/output price per million tokens, context length, supported inputs, release date, model page link, slug
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `sort` | string | no | `"cheapest"` | Order of models, such as cheapest for lowest input token price first. One of "newest", "cheapest", "most_used". Default "newest". |
| `query` | string | no | `"Anthropic"` | Provider name or model keyword, such as Anthropic or vision. Leave blank for all models. Default "". |
| `max_results` | integer | no | `5` | Maximum models to return, such as 50. Default 50. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "sort": "cheapest",
  "query": "Anthropic",
  "max_results": 5
}
```

Its output:

```json
{
  "models": [
    {
      "provider": "Anthropic",
      "model_name": "Anthropic: Claude Haiku 5.5 (batch)",
      "model_slug": "anthropic/claude-haiku-5.5:batch",
      "release_date": "2026-10-07",
      "model_page_link": "https://openrouter.ai/models/anthropic/claude-haiku-5.5:batch",
      "supported_inputs": [
        "text",
        "image",
        "file"
      ],
      "context_length_tokens": 1000000,
      "input_price_usd_per_million_tokens": 0.05,
      "output_price_usd_per_million_tokens": 0.25
    },
    {
      "provider": "Anthropic",
      "model_name": "Anthropic: Claude Haiku 5.5",
      "model_slug": "anthropic/claude-haiku-5.5",
      "release_date": "2026-10-07",
      "model_page_link": "https://openrouter.ai/models/anthropic/claude-haiku-5.5",
      "supported_inputs": [
        "text",
        "image",
        "file"
      ],
      "context_length_tokens": 1000000,
      "input_price_usd_per_million_tokens": 0.1,
      "output_price_usd_per_million_tokens": 0.5
    },
    {
      "provider": "Anthropic",
      "model_name": "Anthropic: Claude Haiku Latest",
      "model_slug": "~anthropic/claude-haiku-latest",
      "release_date": "2026-04-27",
      "model_page_link": "https://openrouter.ai/models/~anthropic/claude-haiku-latest",
      "supported_inputs": [
        "text",
        "image",
        "file"
      ],
      "context_length_tokens": 1000000,
      "input_price_usd_per_million_tokens": 0.1,
      "output_price_usd_per_million_tokens": 0.5
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"openrouter.ai/list_models","input":{"sort":"cheapest","query":"Anthropic","max_results":5}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the cheapest vision-capable models with their per-million input prices and context lengths
- Which models from Anthropic are available right now, sorted by release date?
- List the 20 most used LLMs with their output token pricing
- I need a table of recent open-weight models including slugs and links to their model pages on OpenRouter
- Find models that accept image input and have a context window over 100k tokens

## Input schema

```json
{
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "newest",
        "cheapest",
        "most_used"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order of models, such as cheapest for lowest input token price first."
    },
    "query": {
      "type": "string",
      "default": "",
      "description": "Provider name or model keyword, such as Anthropic or vision. Leave blank for all models."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum models to return, such as 50."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "models"
  ],
  "properties": {
    "models": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "model_name",
          "provider",
          "input_price_usd_per_million_tokens",
          "output_price_usd_per_million_tokens",
          "context_length_tokens",
          "supported_inputs",
          "release_date",
          "model_page_link",
          "model_slug"
        ],
        "properties": {
          "provider": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "model_slug": {
            "type": "string"
          },
          "release_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "model_page_link": {
            "type": "string"
          },
          "supported_inputs": {
            "type": "array",
            "items": {
              "enum": [
                "text",
                "image",
                "audio",
                "file"
              ],
              "type": "string"
            }
          },
          "context_length_tokens": {
            "type": [
              "integer",
              "null"
            ]
          },
          "input_price_usd_per_million_tokens": {
            "type": [
              "number",
              "null"
            ]
          },
          "output_price_usd_per_million_tokens": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [OpenRouter API: Get model details](https://fous.com/methods/openrouter.ai/get-model.md): Looks up an OpenRouter model by name, slug or model link and returns its prices, limits, supported inputs, release date and hosting providers.
- [Hugging Face API: Search models](https://fous.com/methods/huggingface.co/search-models.md): Finds public Hugging Face models by search words, with an optional task and sort order. License is null when the model does not publish one.
- [Hugging Face API: List trending models](https://fous.com/methods/huggingface.co/list-trending-models.md): Lists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days.
- [crates.io API: Search crates](https://fous.com/methods/crates.io/search-crates.md): Finds Rust crates on crates.io by keywords, sorted by relevance, total downloads, recent downloads, or newest creation.
- [Rotten Tomatoes API: List movies](https://fous.com/methods/rottentomatoes.com/list-movies.md): Lists Rotten Tomatoes movies in theaters, coming soon, or at home, by genre and site sort order, with scores, release dates, age ratings, posters and links.
- [Hugging Face API: Search datasets](https://fous.com/methods/huggingface.co/search-datasets.md): Finds public Hugging Face datasets by name or topic, ordered by downloads, likes, trending score or last update.
- [Medium API: List topic articles](https://fous.com/methods/medium.com/list-topic-articles.md): Lists public Medium articles for a topic, newest first or popular this week, with author, publication, reading time, claps and membership status.
- [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
- [All OpenRouter methods](https://fous.com/methods/openrouter.ai.md)
