---
title: "Get Providers"
method: GET
path: "/v1/admin/providers"
tags: ["Admin"]
---

# Get Providers

`GET /v1/admin/providers`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

## Query parameters

- `router_id` integer, nullable: Filter providers by router ID.
- `offset` integer: Number of providers to skip.
- `limit` integer: Maximum number of providers to return.
- `sort_by` 'id' | 'model_name' | 'created'
- `sort_order` 'asc' | 'desc'

## Response `200`

Successful Response

- ProvidersResponse
  - `object` 'list': Type of the object.
  - `total` integer, required: Total number of providers.
  - `offset` integer, required: Offset of the providers list.
  - `limit` integer, required: Limit of the providers list.
  - `data` ProviderResponse[], required: List of providers.
    - `object` 'provider': Type of the object.
    - `id` integer, required: provider ID.
    - `router_id` integer, required: ID of the router that owns the provider.
    - `user_id` integer, required: ID of the user that owns the provider.
    - `type` 'albert' | 'openai' | 'mistral' | 'tei' | 'vllm', required
    - `url` string, nullable: provider API url. The url must only contain the domain name (without `/v1` suffix for example).
    - `timeout` integer, required: Timeout for the provider requests, after user receive an 500 error (model is too busy).
    - `model_name` string, required: Model name from the model provider.
    - `model_hosting_zone` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATA' | 'ATF' | 'ATG' | 'AUS' | 'AUT' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BES' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BVT' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HMD' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PSE' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SJM' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'UMI' | 'URY' | 'USA' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WOR' | 'WSM' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE'
    - `model_total_params` integer: Total params of the model in billions of parameters for carbon footprint computation. If not provided, the active params will be used if provided, else carbon footprint will not be computed. For more information, see https://ecologits.ai
    - `model_active_params` integer: Active params of the model in billions of parameters for carbon footprint computation. If not provided, the total params will be used if provided, else carbon footprint will not be computed. For more information, see https://ecologits.ai
    - `max_context_length` integer, nullable: Maximum amount of tokens a context could contains, probed on the provider API. It is the same for all the providers of a router.
    - `vector_size` integer, nullable: Dimension of the vectors, probed on the provider API for embeddings models only. It is the same for all the providers of a router.
    - `created` integer, nullable: Time of creation, as Unix timestamp.
    - `updated` integer, nullable: 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

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-09-21** `5fdbd3614b8c`: 1 breaking, 1 warning
  - removed the required property `data/items/qos_metric` from the response with the `200` status
  - removed the optional property `data/items/qos_limit` from the response with the `200` status
- **2026-09-02** `b40c3f5c7bfe`: 2 info
  - added the optional property `data/items/max_context_length` to the response with the `200` status
  - added the optional property `data/items/vector_size` to the response with the `200` status
- **2026-06-17** `bb2cc02e42b8`: 1 warning
  - removed the optional property `data/items/key` from the response with the `200` status

[Operation history](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/admin/providers/get.md)

---

[API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [All operations](https://skmtc.dev/betagouv/apis/opengatellm/llms.txt) - [OpenAPI document](https://skmtc.dev/betagouv/apis/opengatellm/revisions/2f7a4a0aac8f?raw)