---
title: "Get a voice"
method: GET
path: "/v1/audio/voices/{voice}"
tags: ["Audio"]
---

# Get a voice

`GET /v1/audio/voices/{voice}`

## Request

- Base URL: `https://api.boson.ai`
- URL: `https://api.boson.ai/v1/audio/voices/{voice}`
- Auth: HTTP bearer

Fetch a single reference voice by ID.

## Path parameters

- `voice` string, required

## Response `200`

The requested voice.

- VoiceObject
  - `voice` string, required: Stable ID `voice_<sha256>`, deterministic per (API key, audio content).
  - `description` string, nullable: Description for the voice.
  - `created_at` string, nullable: ISO-8601 UTC timestamp.
  - `ref_text` string, required: Transcript of the reference audio.

## Other responses

- `401`: Missing or invalid API key.
- `404`: No voice with that ID (`voice_not_found`).

## Changes

- **2026-11-03** `68bf7c248c4c`: 4 info
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/code` to the response with the `404` status
  - added the optional property `error/param` to the response with the `401` status
  - added the optional property `error/param` to the response with the `404` status

[Operation history](https://skmtc.dev/boson/apis/boson-ai-api/changes/v1/audio/voices/:voice/get.md)

---

[API](https://skmtc.dev/boson/apis/boson-ai-api.md) - [All operations](https://skmtc.dev/boson/apis/boson-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/boson/apis/boson-ai-api/revisions/68bf7c248c4c?raw)