---
title: "List Hosted Providers"
method: GET
path: "/api/v1/hosted-providers"
tags: ["hosted-providers"]
---

# List Hosted Providers

`GET /api/v1/hosted-providers`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Otari-Key`
  - API key in header `x-api-key`

List the providers this deployment serves hosted inference on.

Stored providers and those defined in the configuration's
``hosted_providers:`` block alike, each marked with its ``source``.

## Query parameters

- `skip` integer
- `limit` integer

## Response `200`

Successful Response

- HostedProvidersPublic: A page of hosted providers, and how many there are in total.
  - `count` integer, required
  - `data` HostedProviderPublic[], required
    - `api_base` string, nullable
    - `api_key_last4` string, nullable
    - `client_args` object, nullable
    - `created_at` string, date-time, nullable
    - `decryptable` boolean
    - `enabled` boolean, required
    - `has_api_key` boolean
    - `id` string, uuid, nullable
    - `name` string, required
    - `provider` string, required
    - `restricted_to_organization_id` string, uuid, nullable
    - `shadows_config` boolean
    - `source` 'database' | 'config'
    - `updated_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `3d8fba047d0e`: 3 info
  - added the optional property `data/items/decryptable` to the response with the `200` status
  - added the optional property `data/items/has_api_key` to the response with the `200` status
  - added the required property `data/items/name` to the response with the `200` status
- **2026-10-16** `1c433ac914dc`: 4 breaking, 2 info
  - the response property `data/items/created_at` became optional for the status `200`
  - the response property `data/items/id` became optional for the status `200`
  - response property `data/items/created_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …2 more
- **2026-10-16** `cde937c0ea7e`: 2 warning, 4 info
  - removed the optional property `data/items/shadows_config` from the response with the `200` status
  - removed the optional property `data/items/source` from the response with the `200` status
  - the response property `data/items/created_at` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/mozilla-ai/apis/otari/changes/api/v1/hosted-providers/get.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc.dev/mozilla-ai/apis/otari/revisions/2c95b115b0a8?raw)