---
title: "Get a speaker"
method: GET
path: "/v1/speakers/{speaker_id}"
tags: ["Speakers"]
---

# Get a speaker

`GET /v1/speakers/{speaker_id}`

## Request

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

Returns one speaker of your account and how many voice samples it has. An unknown `speaker_id` returns 404. Requires scope `speakers:read`.

## Path parameters

- `speaker_id` string, required: Your identifier for the speaker.

## Response `200`

Success.

- SpeakerObject
  - `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
  - `request_id` string, required
  - `object` 'speaker', 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.
- `404`: Not found. Also returned for resources that belong to another account.
- `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)