---
title: "List Model Routers"
method: GET
path: "/v1/routers"
tags: ["Model Router"]
---

# List Model Routers

`GET /v1/routers`

List Model Router configurations for the authenticated organization with cursor-based pagination.

## Query parameters

- `cursor` string
- `limit` integer, required

## Headers

- `X-Runway-Version` '2024-11-06', required

## Response `200`

A paginated list of Model Router configurations.

- object
  - `data` object[], required — The list of items for the current page.
    - `id` string, uuid, required — The Model Router's primary key ID (UUID). Use it to manage this router via the API; use the slug to reference the router in generation requests.
    - `slug` string, required — Immutable slug used to reference this Model Router in generation requests (for example, production-video). Unique within the API project. The UUID id remains the canonical management identifier.
    - `name` string, required — Human-friendly Model Router display name shown in the dev portal. Mutable, and not used to reference the router in requests.
    - `description` string, nullable, required — An optional Model Router description.
    - `version` integer, required — Current settings version. Increments when settings change; name and description updates do not create a new version.
    - `settings` object, required
      - `schemaVersion` 1, required — Settings JSON schema version used when this snapshot was written.
      - `models` object — When mode is allow_new_except, ids are excluded; when allowlist_only, ids are the only allowed values. Each id must be a known public video or image model name (unknown ids are rejected on create/update).
        - `mode` 'allow_new_except' | 'allowlist_only', required
        - `ids` string[], required
      - `maxCreditsPerGeneration` object — Optional per-modality credit caps, applied per generated output. Models whose estimated per-output cost exceeds the cap are excluded.
        - `video` integer
        - `image` integer
        - `audio` integer
      - `optimizeFor` 'cost' | 'latency' | 'quality' — Soft preference among eligible models: cost, latency, or quality.
      - `fallback` object — Opt-in behavior for what routing should do when the preferred model cannot start immediately.
        - `onCapacity` boolean — When true, if the account is at its concurrency limit on the preferred model, routing skips it and picks the next-best eligible model instead of queueing. If every eligible model is at its limit, the original best-ranked model is used and the task queues as usual.
    - `createdAt` string, date-time, required — When the Model Router was created.
    - `updatedAt` string, date-time, required — When the Model Router was last updated.
  - `hasMore` boolean, required — Whether there are more items available after this page.
  - `nextCursor` string, nullable, required — Cursor to use for fetching the next page, or null if there are no more pages.

---

[API](https://skmtc.net/runwayml/apis/runwayml-api.md) · [All operations](https://skmtc.net/runwayml/apis/runwayml-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runwayml/runwayml-api/revisions/cbbe796a13a0/schema)