API Reference / Speakers
Get a speaker
GET/v1/speakers/{speaker_id}
Returns one speaker of your account and how many voice samples it has. An unknown speaker_id returns 404. Requires scope speakers:read.
Authentication
Send your API key as Authorization: Bearer <your API key>.
Headers
| Name | Type | Details |
|---|---|---|
Authorizationrequired | string |
|
Path parameters
| Name | Type | Details |
|---|---|---|
speaker_idrequired | string | Your identifier for the speaker. pattern |
Response
200 Success.
speaker_idstringrequiredpattern
^[A-Za-z0-9_.:-]{1,64}$display_namestring or nullrequiredsamplesintegerrequiredActive enrollment samples for the current speaker model (max 5).
created_atstringrequiredupdated_atstringrequiredrequest_idstringrequiredobjectstringrequiredalways
"speaker"
Example response
{
"request_id": "req_8f14e45fceea167a5a36dedd",
"object": "speaker",
"speaker_id": "customer-4711",
"display_name": "Ada Lovelace",
"samples": 2,
"created_at": "2026-10-13T09:30:00Z",
"updated_at": "2026-10-13T09:41:12Z"
}Errors
| Status | Meaning |
|---|---|
| 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. |
Error bodies share one shape with a stable error.code; see Errors for every code and how to fix it.
Code samples
curl "https://platform.detectif.ai/v1/speakers/alice" \
-H "Authorization: Bearer $DETECTIF_API_KEY"import os
import requests
resp = requests.get(
"https://platform.detectif.ai/v1/speakers/alice",
headers={"Authorization": f"Bearer {os.environ['DETECTIF_API_KEY']}"},
timeout=30,
)
print(resp.status_code, resp.json())const res = await fetch("https://platform.detectif.ai/v1/speakers/alice", {
headers: {
Authorization: `Bearer ${process.env.DETECTIF_API_KEY}`,
},
});
console.log(res.status, await res.json());