--- title: List custom providers --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [AI Gateway](https://developers.cloudflare.com/api/python/resources/ai_gateway) [Custom Providers](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/custom_providers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List custom providers ai\_gateway.custom\_providers.list(CustomProviderListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[CustomProviderListResponse]()] GET/accounts/{account\_id}/ai-gateway/custom-providers Lists the custom providers configured for the account, ordered by position and then name. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `AI Gateway Write``AI Gateway Read` ##### ParametersExpand Collapse account\_id: str [Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) beta: Optional\[[bool]()] [Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20beta%20%3E%20(schema)>) enable: Optional\[[bool]()] [Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20enable%20%3E%20(schema)>) page: Optional\[int] minimum1 [Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] maximum100 minimum1 [Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) search: Optional\[str] Search by id, name, slug [Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20search%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class CustomProviderListResponse: … id: str formatuuid Link to this property base\_url: str formaturi Link to this property created\_at: datetime formatdate-time Link to this property modified\_at: datetime formatdate-time Link to this property name: str Link to this property slug: str Link to this property beta: Optional\[bool] Link to this property curl\_example: Optional\[str] Link to this property description: Optional\[str] Link to this property enable: Optional\[bool] Link to this property headers: Optional\[str] JSON object of extra HTTP headers that AI Gateway sends to the provider. Values can contain credentials. maxLength8192 Link to this property js\_example: Optional\[str] Link to this property link: Optional\[str] Link to this property logo: Optional\[str] Link to this property position: Optional\[int] Link to this property
[Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(model)%20custom_provider_list_response%20%3E%20(schema)>) ### List custom providers Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.ai_gateway.custom_providers.list( account_id="3ebbcb006d4d46d7bb6a8c7f14676cb0", ) page = page.result[0] print(page.id) ``` 200 example ``` { "result": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "base_url": "https://example.com", "created_at": "2019-12-27T18:11:19.117Z", "modified_at": "2019-12-27T18:11:19.117Z", "name": "name", "slug": "slug", "beta": true, "curl_example": "curl_example", "description": "description", "enable": true, "headers": "headers", "js_example": "js_example", "link": "link", "logo": "logo", "position": 0 } ], "success": true } ``` ##### Returns Examples 200 example ``` { "result": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "base_url": "https://example.com", "created_at": "2019-12-27T18:11:19.117Z", "modified_at": "2019-12-27T18:11:19.117Z", "name": "name", "slug": "slug", "beta": true, "curl_example": "curl_example", "description": "description", "enable": true, "headers": "headers", "js_example": "js_example", "link": "link", "logo": "logo", "position": 0 } ], "success": true } ```