---
title: "List voice designs"
method: GET
path: "/voice_designs"
tags: ["Voice Designs"]
---

# List voice designs

`GET /voice_designs`

Returns a paginated list of voice designs belonging to the authenticated account.

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `filter[name]` string
- `sort` 'name' | '-name' | 'created_at' | '-created_at'

## Response `200`

A paginated list of voice designs.

- VoiceDesignListResponse — Paginated list of voice designs.
  - `data` VoiceDesignSummaryData[] — Array of voice design summary objects.
    - `record_type` 'voice_design' — Identifies the resource type.
    - `id` string, uuid — Unique identifier for the voice design.
    - `name` string — Name of the voice design.
    - `created_at` string, date-time — Timestamp when the voice design was first created.
    - `updated_at` string, date-time — Timestamp when the voice design was last updated.
    - `provider` 'telnyx' | 'minimax' | 'null', nullable — Voice synthesis provider used for this design.
    - `provider_supported_models` string[] — List of TTS model identifiers supported by this design's provider.
  - `meta` VoiceDesignsPaginationMeta — Pagination metadata returned with list responses.
    - `page_number` integer — Current page number (1-based).
    - `page_size` integer — Number of results per page.
    - `total_results` integer — Total number of results across all pages.
    - `total_pages` integer — Total number of pages.

## Other responses

- `401` — Unauthorized — missing or invalid bearer token.

---

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