---
title: "GET /services — Services"
url: https://lumean.app/en/developers/docs/api/get-services
locale: en
description: Services
generated: 2026-11-17
operationId: serviceCatalog.index
method: GET
path: /services
scopes: ["templates.read|orders.read|voices.read"]
spec_version: 1.0.0
---

# GET /services

**Services**

Every service available to you, keyed by the service code: whether it accepts orders
(`status`), its state (`available`, `maintenance`, `disabled`) with a message for the
user, the type (`tts`, `dubbing`, `image`, …), capabilities (templates, voice library,
dubbing, voice cloning), the voice providers for `GET /voices?provider=…` and
`/voices/{provider}/clones`, and the health block of the status page. Use it instead of
a hard-coded list of services: a new service appears here by itself.

**Required key permission:** any of `templates.read`, `orders.read`, `voices.read`.

- Required scope: `templates.read|orders.read|voices.read`

## Request

```bash
curl -X GET 'https://api.lumean.app/api/public/services' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'
```

## Parameters

| Field | In | Type | Req. | Description |
| --- | --- | --- | --- | --- |
| `X-Locale` | header | `string` | — | Language of the localised texts in the response (`message`, labels, failure reasons), an ISO-639-1 code. Optional; without it — the key owner’s account language, then `Accept-Language`, then the default language. An unknown or unsupported code is skipped as if it were absent. |
| `X-Timezone` | header | `string` | — | IANA time zone (`Europe/Moscow`) in which the response shows moments in time — ISO-8601 with an offset. Optional; without it dates come in UTC. An invalid zone is ignored. The server returns the applied zone in the response header of the same name. |

## Request body

No body.

## Responses

### 200 — Success. The payload is in `data`.

**Response fields**

| Field | Type | Req. | Description |
| --- | --- | --- | --- |
| `success` | `boolean` | required | Success flag. Branch on the HTTP status code instead: any 2xx response carries `true` here, while an error comes back in a different shape that need not contain this field at all. |
| `message` | `string` | required | A human-readable note in the account language. Fine to show to a user; do not parse it — the wording changes without notice and is not an error code. |
| `data` | `object` | required | The response payload. |
| `data.*` | `object` — arbitrary keys | — |  |

**Example**

```json
{
  "success": true,
  "message": "Services retrieved.",
  "data": {
    "elevenlabs": {
      "code": "elevenlabs",
      "name": "ElevenLabs",
      "type": "tts",
      "order": 1,
      "access": "public",
      "status": true,
      "state": "available",
      "message": null,
      "maintenance": {
        "enabled": false,
        "since": null,
        "message": null
      },
      "capabilities": {
        "templates": true,
        "voice_library": true,
        "voice_filters": true,
        "voice_clone": false,
        "dubbing": true
      },
      "task_types": [
        "tts"
      ],
      "voice_provider": "elevenlabs",
      "clone_provider": null,
      "dubbing_service": "elevenlabs_dub",
      "health": {
        "status": "operational",
        "stability_index": 98,
        "latency_seconds": 4.1,
        "latency_unit": "chunk",
        "error_level": "normal",
        "queue": {
          "state": "few",
          "approx": null,
          "wait_seconds": 30,
          "load": "low"
        }
      }
    },
    "cartesia": {
      "code": "cartesia",
      "name": "Cartesia",
      "type": "tts",
      "order": 3,
      "access": "public",
      "status": false,
      "state": "maintenance",
      "message": "The service is under maintenance.",
      "maintenance": {
        "enabled": true,
        "since": "2026-11-07T10:15:00+03:00",
        "message": "The service is under maintenance."
      },
      "capabilities": {
        "templates": true,
        "voice_library": true,
        "voice_filters": true,
        "voice_clone": true,
        "dubbing": true
      },
      "task_types": [
        "tts"
      ],
      "voice_provider": "cartesia",
      "clone_provider": "cartesia",
      "dubbing_service": "cartesia_dub",
      "health": {
        "status": "maintenance",
        "stability_index": null,
        "latency_seconds": null,
        "latency_unit": "chunk",
        "error_level": "normal",
        "queue": {
          "state": "none",
          "approx": null,
          "wait_seconds": null,
          "load": "low"
        }
      }
    }
  }
}
```

### 401 — The key is missing, unknown, disabled or expired.

**Response fields**

| Field | Type | Req. | Description |
| --- | --- | --- | --- |
| `success` | `boolean` | required | Always `false` in error responses. |
| `message` | `string` | required | Error text in the key's language (set through the `X-Locale` header). |
| `data` | `null` — nullable | required | Always `null` when the request is rejected before processing. |

**Example**

```json
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
```

### 403 — The key lacks the required permission, or the object belongs to another user.

**Response fields**

| Field | Type | Req. | Description |
| --- | --- | --- | --- |
| `success` | `boolean` | required | Always `false` in error responses. |
| `message` | `string` | required | Error text in the key's language (set through the `X-Locale` header). |

**Example**

```json
{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}
```

---

- This page in the browser: https://lumean.app/en/developers/docs/api/get-services
- Full machine-readable reference: https://api.lumean.app/docs/llm.md
