Responses are generated using AI and may contain mistakes.
Bland is getting a major upgrade. We're working on updating our docs as users transition in the coming weeks. Reach out to support@bland.ai with questions.
Returns the catalog of publicly-shared voices in the Bland library. These are voices that other creators have published for everyone to use; they are not in your org’s library until you call Add Library Voice.Use this endpoint to power voice-picker UIs and discovery flows.
Headers
string
required
Your API key for authentication.
Query Parameters
integer
default:"50"
Number of voices to return.
integer
default:"0"
Pagination offset.
string
Free-text search across voice name, description, and tags.
string
Filter to voices tagged for a specific language (for example en, es, ja).
Response
array
Array of shared voices.
Show Voice fields
string
UUID of the shared voice. Pass to Add Library Voice to add it to your org.
string
Display name in the public library.
string | null
string
The voice’s underlying TTS service. Examples: BTTS_V2, BTTS_V3.
boolean
true if the voice is part of the creator program. Creator voices may carry a per-character fee in addition to the synthesis cost.
number
Total number of ratings the voice has received.
number
Alias of ratings returned for backwards compatibility.
number
Average rating, 0-5.
number
Internal score used to surface trending voices in the dashboard.
string[]
string
ISO 8601 timestamp.
boolean
Always true for entries in the shared library.
string | null
Name of the creator who published the voice, if applicable.
number | null
Per-character creator fee in cents per 1,000 characters. null for non-creator voices.
number | null
Per-character creator fee in cents per 10,000 characters. null for non-creator voices.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Bland","colors":{"primary":"#CA071A","light":"#FFFDF6","dark":"#151515"},"logo":{"light":"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/light.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=c9e5f30d1a8880ad00ef715c1ffa2215","dark":"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/dark.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=be3890a932c8cd55b89ac9df2d018955"},"favicon":"https://mintcdn.com/blandai/7XcPgtv7sOmwQOkQ/favicon.png?fit=max\u0026auto=format\u0026n=7XcPgtv7sOmwQOkQ\u0026q=85\u0026s=03a241cc1c1162995574df4a2166b331","background":{"color":{"light":"#FFFDF5","dark":"#151515"}},"navbar":{"links":[{"href":"https://app.bland.ai/dashboard/support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.bland.ai"}},"footer":{"socials":{"twitter":"https://twitter.com/usebland","linkedin":"https://www.linkedin.com/company/bland-ai","discord":"https://discord.gg/QvxDz8zcKe"}},"seo":{"indexing":"all"},"banner":{"content":"Bland is getting a major upgrade. We're working on updating our docs as users transition in the coming weeks. Reach out to [support@bland.ai](mailto:support@bland.ai) with questions.","dismissible":true},"contextual":{"options":["copy","view","claude","chatgpt","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/QvxDz8zcKe"},{"anchor":"Submit a support ticket","icon":"ticket","href":"https://app.bland.ai/dashboard/support"},{"anchor":"Blog","icon":"newspaper","href":"https://www.bland.ai/blog"},{"anchor":"Enterprise inquiries","icon":"building","href":"https://www.bland.ai/book-a-demo"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"blandai","hasAudioNarration":false,"actualSubdomain":"blandai","customDomains":["docs.bland.ai"],"gitSource":{"type":"github","owner":"cintellilabs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af815e828ec4545927893eb","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Voice Agents","count":516},{"language":"default","tag":"API Reference","count":419},{"language":"default","tag":"Legacy","count":104},{"language":"default","tag":"Documentation","count":97},{"language":"default","tag":"Changelog","count":50},{"language":"default","tag":"Change Log","count":50},{"language":"default","tag":"TTS","count":42},{"language":"default","tag":"Evals","count":36},{"language":"default","tag":"Dispositions","count":31},{"language":"default","tag":"Triage","count":26}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600\u0026display=swap');.card h2+.prose{margin-top:0.75rem}#content-area #header .mt-2 p{font-size:1rem}:root{--splash-font-display: ui-sans-serif, -apple-system, \"Segoe UI\", system-ui, sans-serif;--splash-font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, monospace}.splash-display{font-family:var(--splash-font-display)}.splash-mono{font-family:var(--splash-font-mono)}@keyframes splash-settle{from{opacity:0;transform:scale(0.86)}to{opacity:1;transform:none}}@keyframes splash-breathe{0%,38%{opacity:1}50%,76%{opacity:0}88%,100%{opacity:1}}@media (prefers-reduced-motion: no-preference){.splash-settle{animation:splash-settle 380ms cubic-bezier(0.22, 0.61, 0.36, 1) both;transform-origin:center}.splash-breathe{animation:splash-breathe var(--splash-breathe-dur, 19s) ease-in-out infinite;animation-delay:var(--splash-breathe-delay, 0s)}.splash-cell{transition:transform 240ms cubic-bezier(0.22, 0.61, 0.36, 1)}.splash-cell:hover{transform:scale(1.09);z-index:1}}.splash-frame-a,.splash-diffuse{display:none}.splash-ballast-inset{padding-left:1.5rem;padding-right:1.5rem}.splash-ballast-herotext{padding-top:4rem;padding-bottom:3.5rem}@media (max-width: 1023px){.splash-ballast-herotext{padding-top:calc(4rem + 96px)}}.splash-ballast-h1{font-size:40px;line-height:1.06}@media (min-width: 1152px){.splash-display{--splash-module: clamp(48px, calc((100vw - 1472px) / 12 + 6px), 72px)}.splash-frame-a{display:grid;grid-template-columns:repeat(72, var(--splash-module));grid-template-rows:repeat(8, var(--splash-module))}.splash-diffuse{display:none;grid-template-columns:repeat(72, var(--splash-module));grid-auto-rows:var(--splash-module)}.splash-ballast-inset{padding-left:max(calc(var(--splash-module) * 6), calc((100% - 1472px) / 2 + 48px));padding-right:max(1.5rem, calc((100% - 1472px) / 2 + 48px))}.splash-ballast-hero{height:calc(var(--splash-module) * 3.94 + 322px)}.splash-ballast-herotext{padding-top:calc(var(--splash-module) * 3.94);padding-bottom:0}.splash-ballast-h1{font-size:58px;line-height:62px}}body:has(.splash-display) header .backdrop-blur{backdrop-filter:none;-webkit-backdrop-filter:none}#sidebar-content{background:#FFFDF5;border-right:1px solid #1515150f;width:var(--sidebar-w)}:root{--sidebar-w: 248px}@media (min-width: 1024px){#body-content{padding-left:var(--sidebar-w)}}:root[class~=\"dark\"] #sidebar-content,.dark #sidebar-content{background:#0f0f0f;border-right-color:#ffffff12}#navigation-items{padding-left:1.25rem;padding-right:1rem;padding-top:1.5rem}#sidebar-content a{font-size:13.5px;line-height:1.35;padding-top:5px;padding-bottom:5px}#navigation-items{padding-left:0.75rem}#navigation-items [class*=\"scroll-area-fade-size\"]{padding-left:0;padding-right:0}#sidebar-content h5,#sidebar-content [class*=\"font-semibold\"]:not(a){font-size:11px;letter-spacing:0.06em;text-transform:uppercase;opacity:0.55;margin-top:1.5rem;margin-bottom:0.35rem}#navigation-items{scrollbar-width:thin;scrollbar-color:transparent transparent}#navigation-items:hover{scrollbar-color:#15151526 transparent}@media (min-width: 1024px){.splash-display{--splash-module: clamp(30px, calc((100vw - var(--sidebar-w) - 96px) / 26), 72px)}.splash-ballast-inset{padding-left:3rem;padding-right:3rem}.splash-ballast-inset.splash-ballast-herotext{padding-left:calc(var(--splash-module) * 6)}}@media (min-width: 1024px){.splash-ballast-inset [class*=\"grid-cols\"]{max-width:1180px}}@media (min-width: 1600px){.splash-display{--splash-module: clamp(30px, min(\n calc((100vw - var(--sidebar-w) - 96px) / 26),\n calc((100vw - 1540px) / 10)\n ), 72px)}.splash-ballast-inset{max-width:1276px;margin-inline:auto}.splash-ballast-inset.splash-ballast-herotext{padding-left:48px}}@media (min-width: 1024px){.splash-display{--splash-rule-gap: 64px}.splash-ballast-hero{height:auto}.splash-ballast-inset.splash-ballast-herotext{padding-bottom:var(--splash-rule-gap)}.splash-ballast-inset[class*=\"py-12\"]{padding-top:var(--splash-rule-gap)}}"}],"page":{"pagePath":"api-v1/get/voices-shared","slug":"/api-v1/get/voices-shared","pageMetadata":{"title":"List Shared Voices","api":"GET https://api.bland.ai/v1/voices/shared","description":"Browse the public Bland voice library.","href":"/api-v1/get/voices-shared"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Browse the public Bland voice library.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Returns the catalog of publicly-shared voices in the Bland library. These are voices that other creators have published for everyone to use; they are not in your org’s library until you call `,_jsx(_components.a,{href:`/api-v1/post/voices-library-add-id`,children:`Add Library Voice`}),`.`]}),`\n`,_jsx(_components.p,{children:`Use this endpoint to power voice-picker UIs and discovery flows.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:`Your API key for authentication.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`50`,id:`param-limit`,children:_jsx(_components.p,{children:`Number of voices to return.`})}),`\n`,_jsx(ParamField,{query:`offset`,type:`integer`,default:`0`,id:`param-offset`,children:_jsx(_components.p,{children:`Pagination offset.`})}),`\n`,_jsx(ParamField,{query:`search`,type:`string`,id:`param-search`,children:_jsx(_components.p,{children:`Free-text search across voice name, description, and tags.`})}),`\n`,_jsx(ParamField,{query:`language`,type:`string`,id:`param-language`,children:_jsxs(_components.p,{children:[`Filter to voices tagged for a specific language (for example `,_jsx(_components.code,{children:`en`}),`, `,_jsx(_components.code,{children:`es`}),`, `,_jsx(_components.code,{children:`ja`}),`).`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`voices`,type:`array`,id:`param-voices`,children:[_jsx(_components.p,{children:`Array of shared voices.`}),_jsxs(Expandable,{title:`Voice fields`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsxs(_components.p,{children:[`UUID of the shared voice. Pass to `,_jsx(_components.a,{href:`/api-v1/post/voices-library-add-id`,children:`Add Library Voice`}),` to add it to your org.`]})}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:_jsx(_components.p,{children:`Display name in the public library.`})}),_jsx(ResponseField,{name:`description`,type:`string | null`,id:`param-description`}),_jsx(ResponseField,{name:`service`,type:`string`,id:`param-service`,children:_jsxs(_components.p,{children:[`The voice’s underlying TTS service. Examples: `,_jsx(_components.code,{children:`BTTS_V2`}),`, `,_jsx(_components.code,{children:`BTTS_V3`}),`.`]})}),_jsx(ResponseField,{name:`is_creator_voice`,type:`boolean`,id:`param-is-creator-voice`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` if the voice is part of the creator program. Creator voices may carry a per-character fee in addition to the synthesis cost.`]})}),_jsx(ResponseField,{name:`ratings`,type:`number`,id:`param-ratings`,children:_jsx(_components.p,{children:`Total number of ratings the voice has received.`})}),_jsx(ResponseField,{name:`rating_count`,type:`number`,id:`param-rating-count`,children:_jsxs(_components.p,{children:[`Alias of `,_jsx(_components.code,{children:`ratings`}),` returned for backwards compatibility.`]})}),_jsx(ResponseField,{name:`rating_avg`,type:`number`,id:`param-rating-avg`,children:_jsx(_components.p,{children:`Average rating, 0-5.`})}),_jsx(ResponseField,{name:`trending_score`,type:`number`,id:`param-trending-score`,children:_jsx(_components.p,{children:`Internal score used to surface trending voices in the dashboard.`})}),_jsx(ResponseField,{name:`tags`,type:`string[]`,id:`param-tags`}),_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp.`})}),_jsx(ResponseField,{name:`public`,type:`boolean`,id:`param-public`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`true`}),` for entries in the shared library.`]})}),_jsx(ResponseField,{name:`creator_display_name`,type:`string | null`,id:`param-creator-display-name`,children:_jsx(_components.p,{children:`Name of the creator who published the voice, if applicable.`})}),_jsx(ResponseField,{name:`creator_fee_cents_per_1k`,type:`number | null`,id:`param-creator-fee-cents-per-1k`,children:_jsxs(_components.p,{children:[`Per-character creator fee in cents per 1,000 characters. `,_jsx(_components.code,{children:`null`}),` for non-creator voices.`]})}),_jsx(ResponseField,{name:`creator_fee_cents_per_10k`,type:`number | null`,id:`param-creator-fee-cents-per-10k`,children:_jsxs(_components.p,{children:[`Per-character creator fee in cents per 10,000 characters. `,_jsx(_components.code,{children:`null`}),` for non-creator voices.`]})})]})]}),`\n`,`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(_components.p,{children:[`Docs for agents: `,_jsx(_components.a,{href:`/llms.txt`,children:`llms.txt`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List Shared Voices","api":"GET https://api.bland.ai/v1/voices/shared","description":"Browse the public Bland voice library.","href":"/api-v1/get/voices-shared"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Returns the catalog of publicly-shared voices in the Bland library. These are voices that other creators have published for everyone to use; they are not in your org’s library until you call `,_jsx(_components.a,{href:`/api-v1/post/voices-library-add-id`,children:`Add Library Voice`}),`.`]}),`\n`,_jsx(_components.p,{children:`Use this endpoint to power voice-picker UIs and discovery flows.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:`Your API key for authentication.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`50`,id:`param-limit`,children:_jsx(_components.p,{children:`Number of voices to return.`})}),`\n`,_jsx(ParamField,{query:`offset`,type:`integer`,default:`0`,id:`param-offset`,children:_jsx(_components.p,{children:`Pagination offset.`})}),`\n`,_jsx(ParamField,{query:`search`,type:`string`,id:`param-search`,children:_jsx(_components.p,{children:`Free-text search across voice name, description, and tags.`})}),`\n`,_jsx(ParamField,{query:`language`,type:`string`,id:`param-language`,children:_jsxs(_components.p,{children:[`Filter to voices tagged for a specific language (for example `,_jsx(_components.code,{children:`en`}),`, `,_jsx(_components.code,{children:`es`}),`, `,_jsx(_components.code,{children:`ja`}),`).`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`voices`,type:`array`,id:`param-voices`,children:[_jsx(_components.p,{children:`Array of shared voices.`}),_jsxs(Expandable,{title:`Voice fields`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsxs(_components.p,{children:[`UUID of the shared voice. Pass to `,_jsx(_components.a,{href:`/api-v1/post/voices-library-add-id`,children:`Add Library Voice`}),` to add it to your org.`]})}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:_jsx(_components.p,{children:`Display name in the public library.`})}),_jsx(ResponseField,{name:`description`,type:`string | null`,id:`param-description`}),_jsx(ResponseField,{name:`service`,type:`string`,id:`param-service`,children:_jsxs(_components.p,{children:[`The voice’s underlying TTS service. Examples: `,_jsx(_components.code,{children:`BTTS_V2`}),`, `,_jsx(_components.code,{children:`BTTS_V3`}),`.`]})}),_jsx(ResponseField,{name:`is_creator_voice`,type:`boolean`,id:`param-is-creator-voice`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` if the voice is part of the creator program. Creator voices may carry a per-character fee in addition to the synthesis cost.`]})}),_jsx(ResponseField,{name:`ratings`,type:`number`,id:`param-ratings`,children:_jsx(_components.p,{children:`Total number of ratings the voice has received.`})}),_jsx(ResponseField,{name:`rating_count`,type:`number`,id:`param-rating-count`,children:_jsxs(_components.p,{children:[`Alias of `,_jsx(_components.code,{children:`ratings`}),` returned for backwards compatibility.`]})}),_jsx(ResponseField,{name:`rating_avg`,type:`number`,id:`param-rating-avg`,children:_jsx(_components.p,{children:`Average rating, 0-5.`})}),_jsx(ResponseField,{name:`trending_score`,type:`number`,id:`param-trending-score`,children:_jsx(_components.p,{children:`Internal score used to surface trending voices in the dashboard.`})}),_jsx(ResponseField,{name:`tags`,type:`string[]`,id:`param-tags`}),_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp.`})}),_jsx(ResponseField,{name:`public`,type:`boolean`,id:`param-public`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`true`}),` for entries in the shared library.`]})}),_jsx(ResponseField,{name:`creator_display_name`,type:`string | null`,id:`param-creator-display-name`,children:_jsx(_components.p,{children:`Name of the creator who published the voice, if applicable.`})}),_jsx(ResponseField,{name:`creator_fee_cents_per_1k`,type:`number | null`,id:`param-creator-fee-cents-per-1k`,children:_jsxs(_components.p,{children:[`Per-character creator fee in cents per 1,000 characters. `,_jsx(_components.code,{children:`null`}),` for non-creator voices.`]})}),_jsx(ResponseField,{name:`creator_fee_cents_per_10k`,type:`number | null`,id:`param-creator-fee-cents-per-10k`,children:_jsxs(_components.p,{children:[`Per-character creator fee in cents per 10,000 characters. `,_jsx(_components.code,{children:`null`}),` for non-creator voices.`]})})]})]}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Response`,numberOfLines:`21`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`21`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"e657b253-ca1f-41cc-b25f-7267ae644519\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"StephenD\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"service\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BTTS_V2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_creator_voice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ratings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rating_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rating_avg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4.5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"trending_score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"english\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"male\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cloned\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-16T09:14:25.232Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"public\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"creator_display_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"creator_fee_cents_per_1k\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"creator_fee_cents_per_10k\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(_components.p,{children:[`Docs for agents: `,_jsx(_components.a,{href:`/llms.txt`,children:`llms.txt`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List Shared Voices","api":"GET https://api.bland.ai/v1/voices/shared","description":"Browse the public Bland voice library.","href":"/api-v1/get/voices-shared"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"Response","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"21\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"voices\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"e657b253-ca1f-41cc-b25f-7267ae644519\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"StephenD\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"service\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"BTTS_V2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_creator_voice\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"ratings\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">12\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"rating_count\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">12\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"rating_avg\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">4.5\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"trending_score\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"tags\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"english\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"male\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"cloned\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"created_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-04-16T09:14:25.232Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"public\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"creator_display_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"creator_fee_cents_per_1k\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"creator_fee_cents_per_10k\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"List Shared Voices","path":"/v1/voices/shared","servers":[{"url":"https://api.bland.ai"}],"method":"get","request":{"security":[],"parameters":{"query":{"limit":{"schema":[{"type":"integer","description":"Number of voices to return."}]},"offset":{"schema":[{"type":"integer","description":"Pagination offset."}]},"search":{"schema":[{"type":"string","description":"Free-text search across voice name, description, and tags."}]},"language":{"schema":[{"type":"string","description":"Filter to voices tagged for a specific language (for example `en` , `es` , `ja` )."}]}},"header":{"authorization":{"schema":[{"type":"string","description":"Your API key for authentication.","required":true}]}},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"voices":[{"type":"array","items":[{"type":"object","properties":{"id":[{"type":"string","description":"UUID of the shared voice. Pass to Add Library Voice to add it to your org."}],"name":[{"type":"string","description":"Display name in the public library."}],"description":[{"type":"object","properties":{}}],"service":[{"type":"string","description":"The voice’s underlying TTS service. Examples: `BTTS_V2` , `BTTS_V3` ."}],"is_creator_voice":[{"type":"boolean","description":"`true` if the voice is part of the creator program. Creator voices may carry a per-character fee in addition to the synthesis cost."}],"ratings":[{"type":"number","description":"Total number of ratings the voice has received."}],"rating_count":[{"type":"number","description":"Alias of `ratings` returned for backwards compatibility."}],"rating_avg":[{"type":"number","description":"Average rating, 0-5."}],"trending_score":[{"type":"number","description":"Internal score used to surface trending voices in the dashboard."}],"tags":[{"type":"array","items":[{"type":"string"}]}],"created_at":[{"type":"string","description":"ISO 8601 timestamp."}],"public":[{"type":"boolean","description":"Always `true` for entries in the shared library."}],"creator_display_name":[{"type":"object","properties":{},"description":"Name of the creator who published the voice, if applicable."}],"creator_fee_cents_per_1k":[{"type":"object","properties":{},"description":"Per-character creator fee in cents per 1,000 characters. `null` for non-creator voices."}],"creator_fee_cents_per_10k":[{"type":"object","properties":{},"description":"Per-character creator fee in cents per 10,000 characters. `null` for non-creator voices."}]}}],"description":"Array of shared voices."}]}}],"examples":{"example":{"value":{"voices":[{"id":"\u003cstring>","name":"\u003cstring>","description":{},"service":"\u003cstring>","is_creator_voice":true,"ratings":123,"rating_count":123,"rating_avg":123,"trending_score":123,"tags":["\u003cstring>"],"created_at":"\u003cstring>","public":true,"creator_display_name":{},"creator_fee_cents_per_1k":{},"creator_fee_cents_per_10k":{}}]}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/blandai/02e9da7d1fa2fc47/script.js"],"subdomain":"blandai","siteName":"Bland","title":"List Shared Voices - Bland","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-26T23:30:00.355Z","originalFileLocation":"api-v1/get/voices-shared.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Browse the public Bland voice library.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bland\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Shared Voices - Bland\">\u003cmeta data-mint-head property=\"og:description\" content=\"Browse the public Bland voice library.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bland\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bland.ai/api-v1/get/voices-shared\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://blandai.mintlify.site/_mintlify/api/og/v2?division=Discovery\u0026amp;title=List+Shared+Voices\u0026amp;description=Browse+the+public+Bland+voice+library.\u0026amp;theme=ebdf2c248cf170693b0cf9f5\u0026amp;signature=40de8a97ada943ee996d6ce214ec6d4fe7439dd1311e7f634f86212da4c46045\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List Shared Voices - Bland\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Browse the public Bland voice library.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blandai.mintlify.site/_mintlify/api/og/v2?division=Discovery\u0026amp;title=List+Shared+Voices\u0026amp;description=Browse+the+public+Bland+voice+library.\u0026amp;theme=ebdf2c248cf170693b0cf9f5\u0026amp;signature=40de8a97ada943ee996d6ce214ec6d4fe7439dd1311e7f634f86212da4c46045\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bland\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#CA071A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bland.ai/api-v1/get/voices-shared\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-v1/get/voices-shared.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bland.ai/#organization\",\"name\":\"Bland\",\"url\":\"https://docs.bland.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/light.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=c9e5f30d1a8880ad00ef715c1ffa2215\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bland.ai#website\",\"name\":\"Bland\",\"url\":\"https://docs.bland.ai\",\"publisher\":{\"@id\":\"https://docs.bland.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bland.ai/api-v1/get/voices-shared#webpage\",\"url\":\"https://docs.bland.ai/api-v1/get/voices-shared\",\"name\":\"List Shared Voices\",\"description\":\"Browse the public Bland voice library.\",\"dateModified\":\"2026-06-26T23:30:00.355Z\",\"isPartOf\":{\"@id\":\"https://docs.bland.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bland.ai/api-v1/get/voices-shared#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bland.ai/api-v1/get/voices-shared#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Discovery\",\"item\":\"https://docs.bland.ai/api-v1/post/voices-check-name-availability\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Shared Voices\",\"item\":\"https://docs.bland.ai/api-v1/get/voices-shared\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bland.ai/api-v1/get/voices-shared#apireference\",\"headline\":\"List Shared Voices\",\"name\":\"List Shared Voices\",\"description\":\"Browse the public Bland voice library.\",\"url\":\"https://docs.bland.ai/api-v1/get/voices-shared\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bland.ai/api-v1/get/voices-shared#webpage\"},\"dateModified\":\"2026-06-26T23:30:00.355Z\",\"publisher\":{\"@id\":\"https://docs.bland.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bland.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bland\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bland\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-v1/get/voices-shared.md","siteName":"Bland","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/QvxDz8zcKe"},{"anchor":"Submit a support ticket","icon":"ticket","href":"https://app.bland.ai/dashboard/support"},{"anchor":"Blog","icon":"newspaper","href":"https://www.bland.ai/blog"},{"anchor":"Enterprise inquiries","icon":"building","href":"https://www.bland.ai/book-a-demo"}]},"products":[{"product":"Voice Agents","pages":[{"title":"Voice Agents","href":"/build-your-first-agent"}]},{"product":"TTS","groups":[{"group":"Get Started","pages":[{"title":"Welcome to Bland Speech","href":"/tts/welcome"},{"title":"Speech Quickstart","href":"/tts/quickstart"},{"title":"Realtime TTS Quickstart","href":"/tts/realtime-quickstart"},{"title":"Realtime TTS Concepts","href":"/tts/realtime-concepts"},{"title":"Choosing a Voice","href":"/tts/voices"},{"title":"Writing for Speech","href":"/tts/writing-for-speech"},{"title":"Speech Studio","href":"/tts/speech-studio"},{"title":"Speech Limits","href":"/speech/limits"}]},{"group":"Realtime Speech","pages":[{"title":"Realtime Speech (WebSocket)","href":"/api-v2/post/tts-ws"}]},{"group":"HTTP Speech","pages":[{"title":"Synthesize Speech (HTTP)","api":"POST https://api.bland.ai/v2/tts","href":"/api-v2/post/tts"},{"title":"Speech (OpenAI-compatible)","api":"POST https://api.bland.ai/v2/audio/speech","href":"/api-v2/post/audio-speech"}]},{"group":"Migrate","pages":[{"title":"Migrate to Bland Speech","href":"/tts/migrate"},{"title":"Migrate from ElevenLabs","href":"/tts/migrations/elevenlabs"},{"title":"Migrate from Cartesia","href":"/tts/migrations/cartesia"},{"title":"Migrate from Deepgram","href":"/tts/migrations/deepgram"},{"title":"Migrate from PlayHT","href":"/tts/migrations/playht"},{"title":"Migrate from Resemble AI","href":"/tts/migrations/resemble"},{"title":"Migrate from Google Cloud TTS","href":"/tts/migrations/google-cloud"},{"title":"Migrate from Amazon Polly","href":"/tts/migrations/amazon-polly"}]},{"group":"Voice Cloning","pages":[{"title":"Clone Voice","api":"POST https://api.bland.ai/v1/voices/clone","href":"/api-v1/post/clone"}]},{"group":"Voices","pages":[{"title":"List Voices","api":"GET https://api.bland.ai/v1/voices","href":"/api-v1/get/voices"},{"title":"Get Voice","api":"GET https://api.bland.ai/v1/voices/{id}","href":"/api-v1/get/voices-id"},{"title":"Get Voice Settings","api":"GET https://api.bland.ai/v1/voices/{id}/settings","href":"/api-v1/get/voices-id-settings"},{"title":"Update Voice Settings","api":"POST https://api.bland.ai/v1/voices/{id}/settings","href":"/api-v1/post/voices-id-settings"},{"title":"Update Voice Config","api":"PATCH https://api.bland.ai/v1/voices/{id}/config","href":"/api-v1/patch/voices-id-config"},{"title":"Rename Voice","api":"PATCH https://api.bland.ai/v1/voices/{id}/rename","href":"/api-v1/patch/voices-id-rename"},{"title":"Rate Voice","api":"POST https://api.bland.ai/v1/voices/{id}/rate","href":"/api-v1/post/voices-id-rate"},{"title":"Delete Voice","api":"DELETE https://api.bland.ai/v1/voices/{id}","href":"/api-v1/delete/voices-id"}]},{"group":"Discovery","pages":[{"title":"Check Voice Name Availability","api":"POST https://api.bland.ai/v1/voices/check_name_availability","description":"Check whether a voice name is available before cloning.","href":"/api-v1/post/voices-check-name-availability"},{"title":"List Shared Voices","api":"GET https://api.bland.ai/v1/voices/shared","href":"/api-v1/get/voices-shared"},{"title":"Add Library Voice","api":"POST https://api.bland.ai/v1/voices/library/add/{id}","description":"Add a shared library voice to your org so it can be used in your calls and TTS.","href":"/api-v1/post/voices-library-add-id"}]},{"group":"Samples","pages":[{"title":"List Voice Samples","api":"GET https://api.bland.ai/v1/voices/{id}/samples","href":"/api-v1/get/voices-id-samples"},{"title":"Add Voice Sample","api":"POST https://api.bland.ai/v1/voices/samples","href":"/api-v1/post/voices-samples"},{"title":"Get Voice Sample","api":"GET https://api.bland.ai/v1/voices/{id}/samples/{sample_id}","href":"/api-v1/get/voices-id-samples-sample-id"},{"title":"Update Voice Sample Transcriptions","api":"PATCH https://api.bland.ai/v1/voices/{id}/samples","href":"/api-v1/patch/voices-id-samples"},{"title":"Delete Voice Samples","api":"DELETE https://api.bland.ai/v1/voices/{id}/samples","href":"/api-v1/delete/voices-id-samples"}]},{"group":"Generation History","pages":[{"title":"List TTS Generations","api":"GET https://api.bland.ai/v1/speak/samples","href":"/api-v1/get/speak-samples"},{"title":"Get TTS Generation","api":"GET https://api.bland.ai/v1/speak/samples/{id}","href":"/api-v1/get/speak-samples-id"}]},{"group":"Models","pages":[{"title":"List Models (Public)","api":"GET https://api.bland.ai/v2/models","href":"/api-v2/get/models"},{"title":"List TTS Models","api":"GET https://api.bland.ai/v2/tts/models","href":"/api-v2/get/tts-models"},{"title":"List Voice Models (v1)","api":"GET https://api.bland.ai/v1/models","href":"/api-v1/get/models"}]},{"group":"Tooling","pages":[{"title":"Bland TTS","href":"/sdks/bland-tts"}]}]},{"product":"Changelog","pages":[{"title":"Changelog","href":"/changelog/08_03_2026"}]}]},"basePath":"","title":"List Shared Voices - Bland","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["10e4515597","c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["BannerMarkdown-BjdIPj1P.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DRLI_2Ue.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js"]}