---
title: "List custom model providers"
method: GET
path: "/v1/custom_model_providers"
tags: ["model_providers"]
---

# List custom model providers

`GET /v1/custom_model_providers`

Retrieve a paginated list of user-defined custom model providers. Encrypted provider credentials are never returned. Built-in provider families are listed separately by `GET /v1/model_providers`.

## Query parameters

- `cursor` string, nullable — Cursor for pagination (custom provider ID)
- `limit` integer — The max number of custom providers to return at a time (at most 1000).

## Response `200`

A list of custom model providers with pagination information

- GetCustomModelProvidersResponseBody
  - `data` CustomModelProvider[], required
    - `id` string, required — The ID of the custom provider.
    - `name` string, required — The unique name of the custom provider.
    - `description` string, nullable — An optional description of the custom provider.
    - `provider` string, required — The free-form provider label recorded on the custom provider. Unlike the `provider` of a built-in family, this is not drawn from a fixed set.
    - `sdk` 'openai' | 'azure_openai' | 'anthropic' | 'google_genai' | 'aws_bedrock', required — The SDK used to communicate with the custom provider.
    - `created_at` string, date-time, required — The time the custom provider was created.
    - `updated_at` string, date-time, required — The time the custom provider was last updated.
  - `next_cursor` string, nullable, required

## Other responses

- `403` — Forbidden
- `422` — Unprocessable Entity

## Changes

- **2026-08-24** `2ebe6662d3fd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/changes/v1/custom_model_providers/get.md)

---

[API](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api.md) · [All operations](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arize-ai/arize-phoenix-rest-api/revisions/f440cb6427a5/schema)