# OpenRouter Model Catalog Listing

> OpenRouter Model Catalog Listing is a paid API for AI agents from openrouter.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-09-15, last successful call 2026-07-29).

Returns the list of all available AI models on OpenRouter with their IDs, names, context lengths, pricing, and architecture details

## Facts

- Endpoint: GET https://openrouter.withzero.xyz/api/v1/models
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-07-29
- Success rate: 100% of calls made through Zero
- Activations on Zero: 4
- Provider: openrouter.withzero.xyz
- Website: https://openrouter.withzero.xyz
- Canonical page: https://www.zero.xyz/c/openrouter-withzero-xyz-openrouter-model-catalog-listing-fc0b8c62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QWawDnkJfTRjfAGGOBmW2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability openrouter-withzero-xyz-openrouter-model-catalog-listing-fc0b8c62
```

Example prompt: What AI models are available through this OpenRouter proxy and what are their per-token prices for prompt and completion — I want to pick the cheapest one before sending my chat request.

## When to prefer this

Use this endpoint before calling the chat completion endpoint to discover which model IDs are valid, understand their context limits, and compare per-token pricing. Prefer this over hardcoding model names since available models and prices may change. Ideal for cost-optimization workflows that need to select the cheapest suitable model dynamically.

## Known failure modes

- Upstream OpenRouter API unavailable — returns 5xx error
- Network timeout if OpenRouter is slow to respond
- Empty data array if no models are currently listed
- Authentication or proxy misconfiguration returns 401/403

## How this service works

List all models available via OpenRouter with per-token pricing. Use this to discover model IDs and their costs before calling POST /api/v1/chat. 📖 Full guide: https://openrouter.withzero.xyz/llms.txt

## Output

A JSON object with a 'data' array where each element describes one available model: its string ID and display name, numeric context_length, pricing object with prompt/completion/image/request rates as strings, optional description, and optional architecture object with modality, tokenizer, and instruct_type fields.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "name",
     "context_length",
     "pricing"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "pricing": {
      "type": "object",
      "required": [
       "prompt",
       "completion"
      ],
      "properties": {
       "image": {
        "type": "string"
       },
       "prompt": {
        "type": "string"
       },
       "request": {
        "type": "string"
       },
       "completion": {
        "type": "string"
       }
      },
      "additionalProperties": false
     },
     "description": {
      "type": "string"
     },
     "architecture": {
      "type": "object",
      "required": [
       "modality",
       "tokenizer"
      ],
      "properties": {
       "modality": {
        "type": "string"
       },
       "tokenizer": {
        "type": "string"
       },
       "instruct_type": {
        "type": "string"
       }
      },
      "additionalProperties": false
     },
     "context_length": {
      "type": "number"
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openrouter-withzero-xyz-openrouter-model-catalog-listing-fc0b8c62/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from openrouter.withzero.xyz](https://www.zero.xyz/host/openrouter.withzero.xyz/llms.txt)