# List Custom Models

List all custom models for the authenticated organization. For background, see the [Custom Models guide](/speech-to-text/features/custom-models/).

```
GET https://api.reson8.dev/v1/custom-model
```

## Request

### Headers

| Header        | Value                                         |
|---------------|-----------------------------------------------|
| Authorization | `ApiKey <api_key>` or `Bearer <access_token>` |

See [Authentication](/authentication/) for which header to use in different situations.

### Example

```bash
curl "https://api.reson8.dev/v1/custom-model" \
  -H "Authorization: ApiKey <your_api_key>"
```

```python
import requests

response = requests.get(
    "https://api.reson8.dev/v1/custom-model",
    headers={"Authorization": "ApiKey <your_api_key>"},
)

custom_models = response.json()
```

## Response

`200 OK`

The response is a JSON array of custom models.

| Field            | Type   | Description                           |
|------------------|--------|---------------------------------------|
| `[].id`          | string | Unique identifier of the custom model |
| `[].name`        | string | Name of the custom model              |
| `[].description` | string | Description of the custom model       |
| `[].phraseCount` | number | Number of phrases in the custom model |

### Example

```json
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Cardiology",
    "description": "Cardiology-specific terminology",
    "phraseCount": 3
  }
]
```

## Errors

| Status                    | Description                    |
|---------------------------|--------------------------------|
| 401 Unauthorized          | Missing or invalid credentials |
| 500 Internal Server Error | Unexpected server error        |