---
search:
  tags:
    - AI voices
    - GET
seo:
  description: >-
    The feature's current state, every voice this account can offer (TipPage's
    own, the… Reference for the GET /ai-voices endpoint in the TipPage Developer
    API.
sidebar:
  label: List AI voices
  badge: GET
title: List AI voices
type: openapi-operation
---
The feature's current state, every voice this account can offer (TipPage's own, the ones this streamer cloned, and voices other streamers published), and this month's usage. Being listed IS being offered to donors - the per-voice enable/disable calls add a voice to and remove it from this list. Voice `id`s are stable (`voi_...`). `min_amount` is the tip amount that unlocks AI voices on the tip page. Requires `ai_voices:manage`. Closed beta: answers `404` unless AI voices are enabled for your account.

`GET /ai-voices`

**Responses**

- `200` — Feature state, catalog, and usage.
- `401` — Missing or invalid credential (\`missing\_api\_key\` / \`invalid\_api\_key\`, or \`invalid\_token\` for an expired/revoked OAuth access token).
- `403` — The key lacks the required scope (\`missing\_scope\`).
- `404` — No such resource.
- `429` — Rate limit exceeded - check the \`RateLimit-\*\` headers.

Response example, 200:

```json
{
  "enabled": true,
  "mode": "optional",
  "min_amount": 0,
  "usage": {
    "month": "2026-09",
    "characters_spoken": 0,
    "seconds_generated": 0,
    "generations": 0
  },
  "voices": [
    {
      "id": "voi_9c1f0a2b7d4e5f60",
      "label": "Narrator",
      "hint": "Warm documentary read",
      "gender": "m",
      "sample_url": "string",
      "reference_seconds": 0,
      "source": "platform"
    }
  ]
}
```
