---
title: "Retrieve all voices"
method: GET
path: "/v1/tones"
tags: ["Voices"]
---

# Retrieve all voices

`GET /v1/tones`

Returns a list of voices available to your workspace, sorted from most recently created

## Query parameters

- `q` string
- `page` number
- `size` number

## Response `200`

Retrieve voices

- GetAllTonesResponseDto[]
  - `requestId` string
  - `resource` string
  - `data` ToneDto
    - `name` string, required — The friendly name of the voice.
    - `value` string, required — The voice's description
    - `metadata` object — An optional set of key-value pairs to attach any data you wish to the voice, in a structured format. You can specify up to 10 keys, with key names up to 40 characters long and values up to 500 characters long.
    - `settings` ToneSettingsDto
      - `appVisibility` 'visible' | 'hidden' — Whether the brand is available in the Jasper app. Provides a way to omit voices created from the API, from being available in the Jasper app experience. One of "visible" or "hidden". Defaults to "visible".
    - `id` string
    - `createdAt` string
    - `updatedAt` string
  - `pagination` TonePaginationDto
    - `totalRecords` number — Total number of records
    - `page` number — Current page
    - `pageSize` number — Page size
    - `next` string — URL for requesting the next page
    - `prev` string — URL for requesting the previous page

## Other responses

- `500` — Internal server error. Unable to get voices

---

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