---
title: "Get Voices by Name"
method: GET
path: "/v1/searchVoices"
---

# Get Voices by Name

`GET /v1/searchVoices`

## Request

- Base URL: `https://api.musicgpt.com/api/public`
- URL: `https://api.musicgpt.com/api/public/v1/searchVoices`
- Auth: API key in header `Authorization`

Search for voices to get their voice ID by their names using a query string.

## Query parameters

- `query` string, required
- `limit` integer
- `page` integer

## Response `200`

Successful response

- object
  - `success` boolean
  - `voices` object[]
    - `voice_id` string
    - `voice_name` string
  - `limit` integer
  - `page` integer
  - `total` integer

## Other responses

- `500`: Internal Server Error

---

[API](https://skmtc.dev/musicgpt/apis/musicgpt-api.md) - [All operations](https://skmtc.dev/musicgpt/apis/musicgpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/musicgpt/apis/musicgpt-api/revisions/6753dccf4c5d?raw)