---
title: "Get a single voice from the voice library"
method: GET
path: "/v1/accounts/{accountId}/voice-library/{voiceId}"
tags: ["Voice Library"]
---

# Get a single voice from the voice library

`GET /v1/accounts/{accountId}/voice-library/{voiceId}`

## Request

- Base URL: `https://api.us.poly.ai`
- URL: `https://api.us.poly.ai/v1/accounts/{accountId}/voice-library/{voiceId}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/poly/apis/polyai-agents-api/docs/v1/accounts/:accountId/voice-library/:voiceId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Successful response

- GetVoiceResponse: Response for single voice endpoints.
  - `voice` VoiceResponse, required: A single voice as returned by the public API.
    - `id` string, required: Unique voice identifier
    - `name` string, required: Human-readable voice name
    - `provider` string, required: TTS provider
    - `providerVoiceId` string, required: Voice ID from the TTS provider
    - `config` object, required: Provider-specific voice config
    - `metadata` object: Additional voice metadata
    - `isPolyVoice` boolean: True if this is a Poly-curated voice (vs account-owned)

## Other responses

- `401`: Unauthorized – missing or invalid API key
- `403`: Forbidden – insufficient permissions
- `404`: Resource not found

---

[API](https://skmtc.dev/poly/apis/polyai-agents-api.md) - [All operations](https://skmtc.dev/poly/apis/polyai-agents-api/llms.txt) - [OpenAPI document](https://skmtc.dev/poly/apis/polyai-agents-api/revisions/76f3c606e395?raw)