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

# Get Voices by Name

`GET /v1/searchVoices`

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.net/musicgpt/apis/musicgpt-api.md) · [All operations](https://skmtc.net/musicgpt/apis/musicgpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/musicgpt/musicgpt-api/revisions/6753dccf4c5d/schema)