---
title: "List speakers"
method: GET
path: "/v1/speakers"
tags: ["Speakers"]
---

# List speakers

`GET /v1/speakers`

## Request

- Base URL: `https://platform.detectif.ai`
- URL: `https://platform.detectif.ai/v1/speakers`
- Auth: HTTP bearer

Lists the speakers of your account, newest first, with how many voice samples each has. Use `limit` and `cursor` to page through long lists. Requires scope `speakers:read`.

## Query parameters

- `limit` integer: How many speakers to return (1-100).
- `cursor` string, nullable: `next_cursor` from the previous page.

## Response `200`

Success.

- SpeakerList
  - `request_id` string, required
  - `object` 'list', required
  - `data` Speaker[], required
    - `speaker_id` string, required
    - `display_name` string, nullable, required
    - `samples` integer, required: Active enrollment samples for the current speaker model (max 5).
    - `created_at` string, required
    - `updated_at` string, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: The request is invalid, for example a missing or malformed field.
- `401`: The API key is missing, invalid or revoked.
- `403`: The key lacks the required scope, the email address is not verified, or the account is suspended.
- `429`: Too many requests or too many operations at the same time. Wait for the number of seconds in Retry-After.
- `500`: Something went wrong on our side. No credits were used.

---

[API](https://skmtc.dev/detectif/apis/detectifai-developer-api.md) · [All operations](https://skmtc.dev/detectif/apis/detectifai-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/detectif/apis/detectifai-developer-api/revisions/24295482ed77?raw)