---
title: "Get Routers"
method: GET
path: "/v1/admin/routers"
tags: ["Admin"]
---

# Get Routers

`GET /v1/admin/routers`

## Query parameters

- `offset` integer — Number of routers to skip.
- `limit` integer — Maximum number of routers to return.
- `sort_by` 'id' | 'name' | 'created'
- `sort_order` 'asc' | 'desc'

## Response `200`

Successful Response

- RoutersResponse
  - `object` 'list' — Type of the object.
  - `total` integer, required — Total number of routers.
  - `offset` integer, required — Offset of the routers list.
  - `limit` integer, required — Limit of the routers list.
  - `data` RouterResponse[], required — List of routers.
    - `object` 'router' — Type of the object.
    - `id` integer, required — ID of the router.
    - `name` string, required — Name of the router.
    - `user_id` integer, required — ID of the user that owns the router.
    - `type` 'automatic-speech-recognition' | 'image-text-to-text' | 'image-to-text' | 'text-embeddings-inference' | 'text-generation' | 'text-classification', required
    - `aliases` string[], required — Aliases of the model. It will be used to identify the model by users.
    - `load_balancing_strategy` 'shuffle' | 'least_busy', required
    - `vector_size` integer, nullable — Dimension of the vectors, if the models are embeddings. Make sure it is the same for all models.
    - `max_context_length` integer, nullable — Maximum amount of tokens a context could contains. Make sure it is the same for all models.
    - `cost_prompt_tokens` number, required — Cost of a million prompt tokens (decrease user budget)
    - `cost_completion_tokens` number, required — Cost of a million completion tokens (decrease user budget)
    - `providers` integer — Number of providers in the router.
    - `created` integer, required — Time of creation, as Unix timestamp.
    - `updated` integer, required — Time of last update, as Unix timestamp.

## Other responses

- `401` — Invalid authentication scheme.<br>Invalid API key.
- `403` — User has no admin rights.<br>Your account has expired. Please contact support to renew your account.
- `422` — Validation Error

---

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