---
title: "List custom providers"
method: GET
path: "/api/providers/"
tags: ["models"]
---

# List custom providers

`GET /api/providers/`

List custom providers for the authenticated organization.

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

Paginated custom providers.

- ModelsListCustomProvidersResponse200
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `total_count` integer — Present for dashboard-authenticated callers.
  - `current_filters` object
  - `results` ApiProvidersGetResponsesContentApplicationJsonSchemaResultsItems[], required
    - `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

## Changes

- **2026-08-22** `b18c72975097` — 3 warning
  - for the `query` request parameter `page_size`, the max was set to `1000.00`
  - for the `query` request parameter `page`, the min was set to `1.00`
  - for the `query` request parameter `page_size`, the min was set to `1.00`
- **2026-08-13** `4e064cf81dae` — 5 breaking, 4 warning, 1 info
  - for the `query` request parameter `page`, default value `1` was added
  - for the `query` request parameter `page_size`, default value `100` was added
  - the response property `results/items/created_at` became optional for the status `200`
  - the response property `results/items/updated_at` became optional for the status `200`
  - …6 more
- **2026-07-31** `c26d550029f8` — 1 breaking, 10 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `page_size`
  - removed the non-success response with the status `401`
  - …7 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/providers/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)