---
title: "List Speech Engines"
method: GET
path: "/v1/speech-engine"
tags: ["Speech Engine"]
---

# List Speech Engines

`GET /v1/speech-engine`

Returns a paginated list of Speech Engine resources.

## Query parameters

- `page_size` integer — How many Speech Engines to return at maximum. Can not exceed 100, defaults to 30.
- `search` string, nullable — Search term to filter Speech Engines by name
- `sort_direction` 'asc' | 'desc'
- `sort_by` 'name' | 'created_at' | 'call_count_7d'
- `cursor` string, nullable — Used for fetching next page. Cursor is returned in the response.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- ListSpeechEnginesResponse
  - `speech_engines` SpeechEngineSummaryResponse[], required — The speech engines matching the query
    - `speech_engine_id` string, required — The speech engine resource ID
    - `name` string, required — Human-readable name for the speech engine
    - `created_at_unix_secs` integer, required — Creation time in Unix seconds
    - `tags` string[], required — Arbitrary tags for categorization and filtering
    - `access_info` ResourceAccessInfo, required
      - `is_creator` boolean, required — Whether the user making the request is the creator of the agent
      - `creator_name` string, required — Name of the agent's creator
      - `creator_email` string, required — Email of the agent's creator
      - `role` 'admin' | 'editor' | 'commenter' | 'viewer', required — The role of the user making the request
      - `anonymous_access_level_override` 'admin' | 'editor' | 'commenter' | 'viewer', nullable — The access level for anonymous users. If None, the resource is not shared publicly.
      - `access_source` 'creator' | 'explicit' | 'workspace_admin' | 'workspace_default', nullable — Why the requesting user has access to this resource. 'creator' = caller is the owner. 'explicit' = caller (or one of their workspace groups) is listed in role_to_group_ids beyond the workspace-wide everyone group. 'workspace_default' = the workspace-wide everyone group is listed in role_to_group_ids (every non-anon workspace member, including admins, sees this resource). 'workspace_admin' = caller is a workspace admin and the admin seat is the *only* path to access; reserved for docs nobody else can see. Lets the UI disclose why an admin-bypass viewer sees a doc that wasn't explicitly shared with them.
  - `next_cursor` string, nullable — Cursor for fetching the next page
  - `has_more` boolean, required — Whether there are more results

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/e77a0a530a82/schema)