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

# Get a custom provider

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

## Request

- Base URL: `https://api.respan.ai`
- URL: `https://api.respan.ai/api/providers/{provider_id}/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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

## Response `200`

Provider details.

- object
  - `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

- `403`: The API key is missing, invalid or expired.
- `404`: Not Found

## Changes

- **2026-10-21** `c30bcb383ee8`: 2 breaking, 4 info
  - the response property `created_at` became nullable for the status `200`
  - the response property `updated_at` became nullable for the status `200`
  - api operation id `models_retrieveCustomProvider` removed and replaced with `retrieveCustomProvider`
  - the endpoint scheme security `DashboardJwt` was added to the API
  - …2 more
- **2026-10-02** `b830b79cfd52`: 2 info
  - added the non-success response with the status `403`
  - removed the non-success response with the status `401`
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `RespanApiKey` was added to the API
- **2026-09-12** `22b868ef3f22`: 1 info
  - api operation id `retrieve-custom-provider` removed and replaced with `models_retrieveCustomProvider`

[Operation history](https://skmtc.dev/respan/apis/respan-api/changes/api/providers/:provider_id/get.md)

---

[API](https://skmtc.dev/respan/apis/respan-api.md) - [All operations](https://skmtc.dev/respan/apis/respan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/respan/apis/respan-api/revisions/900841387635?raw)