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

# List Providers

`GET /api/v1/providers`

Returns LLM providers from the catalog with effective config and configured status.

## Response `200`

Provider list

- ProviderList — List of LLM providers from the catalog.
  - `data` Provider[], required
    - `id` string, required — LLM provider identifier.
    - `display_name` string, required — Human-readable provider name.
    - `adapter` 'anthropic' | 'openai' | 'gemini' | 'openai_compatible', required — Protocol adapter the provider speaks.
    - `base_url` string, nullable — Operator-set base URL override, if any.
    - `api_key_url` string, nullable — URL where an operator can obtain an API key for this provider.
    - `priority` integer, required — Catalog ordering priority; higher sorts first.
    - `aliases` string[] — Alternative identifiers that resolve to this provider.
    - `model_count` integer, required — Number of catalog models belonging to this provider.
    - `default_model` string, nullable — Catalog default model ID for this provider, if any.
    - `configured` boolean, required — Whether credential material is present for this provider on the server when this response was produced. Does NOT imply requests will succeed.
    - `expected_secret_name` string, nullable — Suggested vault secret name for configuring this provider, derived from the first vault credential reference in the provider catalog. Null when the provider has no vault credential (e.g. no-auth or env-only providers). Used to prefill the create-secret form.

---

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