Get voice by ID

GET/voices/{id}

Retrieve details for a single voice by its unique ID and provider.

Request

curl -X GET "https://www.getrevox.com/api/voices/4325f426-c4e0-418e-a0e5-97fcdfcdf8e6?provider=cartesia" \
  -H "Authorization: Bearer $REVOX_API_KEY"

const res = await fetch("https://www.getrevox.com/api/voices/4325f426-c4e0-418e-a0e5-97fcdfcdf8e6?provider=cartesia", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
  },
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.get(
    "https://www.getrevox.com/api/voices/4325f426-c4e0-418e-a0e5-97fcdfcdf8e6",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    params={
        "provider": "cartesia",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

{
  "voice": {
    "id": "4325f426-c4e0-418e-a0e5-97fcdfcdf8e6",
    "name": "Camille",
    "description": "Books a slot in the agenda.",
    "language": "en"
  }
}

{ "error": "Not found" }

Path parameters

idstringrequired
The voice ID to get.

Query parameters

provider"cartesia" | "elevenlabs" | "gradium"required
Provider of the voice, as listed by GET /voices.

Request body

No body: send the request without one.

Response

200

voiceobject
The voice.

Errors

404Not found in your organization{ "message"?: string, "error"?: string, "bodyErrors"?: {…} }

Error bodies carry an error (or message) string; a 400 adds bodyErrors.issues. See Errors.