/openrouter/models/endpoints

POST /api/openrouter/models/endpoints

Price: 1 credit

List every provider endpoint serving one OpenRouter model

How to use it

This is the per-provider spread for one model: each row is one provider's hosting of it, with its own price, quantisation, context window, latency and throughput percentiles and recent uptime. Use it to choose a provider, or to see why two callers of the same model see different prices. A model that exists but is not served by anyone returns an empty list rather than 412, and `stats` is absent until a provider has taken measurable traffic.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• model string required — Model alias ('openai/gpt-4o'), dated version alias, or model page URL (examples: "openai/gpt-4o", "https://openrouter.ai/anthropic/claude-fable-5.1"; minLength: 1)
• variant string nullable — Restrict to one billing variant; omitted returns every variant the model sells (one of: "standard", "batch", "free")
• count integer required — Max result count (min: 1)

Response

• @type string (default: "OpenrouterModelEndpoint")
• id string required
• name string nullable
• model_alias string nullable
• model_version_alias string nullable
• provider object nullable
  • @type string (default: "OpenrouterProvider")
  • alias string required
  • name string nullable
  • display_name string nullable
  • adapter_name string nullable
  • base_url string nullable
  • headquarters string nullable
  • datacenters array (default: [])
  • has_chat_completions boolean nullable
  • has_completions boolean nullable
  • is_abortable boolean nullable
  • is_moderation_required boolean nullable
  • is_byok_enabled boolean nullable
  • sends_client_ip boolean nullable
  • pricing_strategy string nullable
  • required_attestation_types array (default: [])
  • status_page_url string nullable
  • image string nullable
  • data_policy object nullable
    • @type string (default: "OpenrouterDataPolicy")
    • is_training boolean nullable
    • is_training_openrouter boolean nullable
    • is_retaining_prompts boolean nullable
    • retention_days integer nullable
    • can_publish boolean nullable
    • requires_user_ids boolean nullable
    • terms_url string nullable
    • privacy_url string nullable
• provider_name string nullable
• provider_model_id string nullable
• provider_region string nullable
• adapter_name string nullable
• variant string nullable
• quantization string nullable
• context_length integer nullable
• max_prompt_tokens integer nullable
• max_completion_tokens integer nullable
• max_tokens_per_image integer nullable
• capacity_tpm integer nullable
• limit_rpm integer nullable
• limit_rpd integer nullable
• status integer nullable
• is_free boolean nullable
• is_hidden boolean nullable
• is_private boolean nullable
• is_byok boolean nullable
• is_byok_only boolean nullable
• is_deranked boolean nullable
• is_disabled boolean nullable
• is_hipaa_eligible boolean nullable
• is_pricing_unresolved boolean nullable
• is_moderation_required boolean nullable
• can_abort boolean nullable
• supports_reasoning boolean nullable
• supports_tool_parameters boolean nullable
• supports_multipart boolean nullable
• has_chat_completions boolean nullable
• has_completions boolean nullable
• supported_parameters array (default: [])
• excluded_parameters array (default: [])
• allowed_passthrough_parameters array (default: [])
• supported_image_parameters object (default: {})
• supported_video_parameters object (default: {})
• features object (default: {})
• data_policy object nullable
  • @type string (default: "OpenrouterDataPolicy")
  • is_training boolean nullable
  • is_training_openrouter boolean nullable
  • is_retaining_prompts boolean nullable
  • retention_days integer nullable
  • can_publish boolean nullable
  • requires_user_ids boolean nullable
  • terms_url string nullable
  • privacy_url string nullable
• pricing object nullable
  • @type string (default: "OpenrouterEndpointPricing")
  • prompt number nullable
  • completion number nullable
  • input_cache_read number nullable
  • input_cache_write number nullable
  • image number nullable
  • image_output number nullable
  • image_token number nullable
  • request number nullable
  • web_search number nullable
  • internal_reasoning number nullable
  • discount number nullable
  • audio number nullable
  • input_audio_cache number nullable
  • input_cache_write_1h number nullable
  • raw object (default: {})
  • display_prices array (default: [])
    • @type string (default: "OpenrouterPriceItem")
    • kind string nullable
    • label string nullable
    • price number nullable
    • unit_label string nullable
    • display_multiplier number nullable
    • tiers array (default: [])
    • is_server_tool boolean nullable
    • is_discount_exempt boolean nullable
    • schedule_windows array (default: [])
• pricing_version_id string nullable
• stats object nullable
  • @type string (default: "OpenrouterEndpointStats")
  • latency_metric string nullable
  • p50_latency number nullable
  • p75_latency number nullable
  • p90_latency number nullable
  • p95_latency number nullable
  • p99_latency number nullable
  • p50_throughput number nullable
  • p75_throughput number nullable
  • p90_throughput number nullable
  • p95_throughput number nullable
  • p99_throughput number nullable
  • latency_request_count integer nullable
  • throughput_request_count integer nullable
  • request_count integer nullable
  • window_minutes integer nullable
• uptime array (default: [])
  • @type string (default: "OpenrouterUptimePoint")
  • date string required
  • uptime number nullable
• p50_latency number nullable
• p50_throughput number nullable
• created_at string nullable
• deprecation_date string nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — No model with that alias Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.