---
title: List
url: https://www.tines.com/docs/api/ai-providers/list/
updated: 2026-07-13T10:24:11+00:00
description: Retrieve the AI providers and models available to the authenticated user.
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/docs/llms.txt) › [Tines API](https://www.tines.com/docs/api/llms.txt) › [AI providers](https://www.tines.com/llm/docs/api/ai-providers.md)*

# List

*[View on tines.com](https://www.tines.com/docs/api/ai-providers/list/)*

## Description

Retrieve the AI providers and models available to the authenticated user.

Admins receive all AI providers configured for the tenant. Non-admin users receive providers owned by one of their teams, shared with one of their teams, or available to the entire tenant. The response includes enabled and disabled providers.

## Request

HTTP Method: **GET**

```bash
curl -X GET \
  https://<tenant-domain>/api/v1/ai_providers \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'
```

## Response

A successful request returns a JSON object containing an array of AI providers. Each provider includes the models that can be selected when configuring Tines AI features.

### Field description

| Parameter         | Description                                                                                                     |
| ----------------- | --------------------------------------------------------------------------------------------------------------- |
| ai_providers      | Array of AI provider objects visible to the authenticated user.                                                 |
| guid              | Unique identifier of the AI provider.                                                                           |
| enabled           | Whether the AI provider is enabled.                                                                             |
| name              | The configured name of the AI provider, or its default provider name when no custom name is set.                |
| provider_type     | Provider service. One of `ANTHROPIC`, `OPEN_AI`, `AWS_BEDROCK`, `ORACLE_COHERE`, `MISTRAL`, or `GOOGLE_VERTEX`. |
| provisioning_type | How the provider is provisioned. One of `customer_provisioned` or `tines_provisioned`.                          |
| models            | Array of models available through the provider.                                                                 |
| display_name      | Display name of the model.                                                                                      |
| api_model_id      | Model identifier used when configuring Tines AI features through the API.                                       |
| description       | Description of the model, or `null` when no description is available.                                           |
| cost_tier         | Relative model cost. One of `LOW`, `MEDIUM`, or `HIGH`, or `null` when no cost tier is available.               |
| legacy            | Whether the model is a legacy model.                                                                            |

### Sample response

```json
{
  "ai_providers": [
    {
      "guid": "2c6c29e7-0f57-42b6-b7f7-663a45299f69",
      "enabled": true,
      "name": "My Anthropic",
      "provider_type": "ANTHROPIC",
      "provisioning_type": "customer_provisioned",
      "models": [
        {
          "display_name": "Sonnet 5",
          "api_model_id": "claude-sonnet-5",
          "description": "Best combination of speed and intelligence for a wide range of tasks",
          "cost_tier": "MEDIUM",
          "legacy": false
        }
      ]
    }
  ]
}
```