---
title: "Retrieve a custom provider"
method: GET
path: "/api/providers/{provider_id}/"
tags: ["models"]
---

# Retrieve a custom provider

`GET /api/providers/{provider_id}/`

Retrieve a custom provider by its string provider ID. The current backend returns `extra_kwargs`, including any credentials stored in that object; handle this response as sensitive.

## Path parameters

- `provider_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Provider details.

- ModelsRetrieveCustomProviderResponse200
  - `id` string, required — Provider string ID. Same value as `provider_id`.
  - `provider_id` string, required — Unique provider identifier within your organization.
  - `provider_name` string, required — Human-readable provider name.
  - `extra_kwargs` object — Stored provider configuration. The current backend returns this object, including credentials it contains; handle the response as sensitive.
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `401` — Unauthorized - Missing or invalid authentication
- `404` — Not Found

## Changes

- **2026-08-13** `4e064cf81dae` — 3 breaking, 3 warning, 2 info
  - the response property `created_at` became optional for the status `200`
  - the response property `updated_at` became optional for the status `200`
  - the `extra_kwargs` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed the optional property `models_sync_config` from the response with the `200` status
  - …4 more
- **2026-07-31** `c26d550029f8` — 1 breaking, 7 info
  - the `extra_kwargs` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
  - added the optional property `models_sync_config` to the response with the `200` status
  - …4 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/providers/:provider_id/get.md)

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/c61efaf24756/schema)