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

# List speakers

`GET /speakers`

Lists all speakers in your organization

## Response `200`

OK

- SpeakerModel[]
  - `id` integer — Unique identifier for the object
  - `first_name` string — The first name of the speaker
  - `last_name` string, nullable — The last name of the speaker
  - `avatar_url` string, nullable — The image URL of the speaker
  - `created` string, date-time — Time at which the object was created (ISO 8601)
  - `updated` string, date-time — Time at which the object was updated (ISO 8601)
  - `custom_voices` CustomVoiceModel[], nullable — The custom voices for the speaker
    - `id` integer — Unique identifier for the object
    - `name` string — The name of the custom voice
    - `script_ids` integer[] — The scripts to assign to the custom voice
    - `cloning_status` 'script-preparation' | 'script-recording' | 'pre-processing' | 'training-model' | 'fine-tuning-model' | 'finished-cloning' — The cloning status of the custom voice
    - `recording_username` string — The unique identifier to be used for recording (omitted when using basic auth)
    - `recording_access` 'none' | 'private' | 'public' — The access level to set for recording (omitted when using basic auth)
    - `recording_password` string — The password to set for recording (omitted when using basic auth)
    - `created` string, date-time — Time at which the object was created (ISO 8601)
    - `updated` string, date-time — Time at which the object was updated (ISO 8601)
  - `voices` object[], nullable — The voices for the speaker
    - `id` integer — Unique identifier for the object
    - `name` string — The name of the voice

## Other responses

- `401` — Invalid authentication token

---

[API](https://skmtc.net/beyondwords/apis/beyondwords-rest-api.md) · [All operations](https://skmtc.net/beyondwords/apis/beyondwords-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beyondwords/beyondwords-rest-api/revisions/8c4bfe3e2ebd/schema)