---
title: "Fetch a single Voiceprint"
method: GET
path: "/voiceprints/{id}"
tags: ["voice"]
---

# Fetch a single Voiceprint

`GET /voiceprints/{id}`

## Request

- Base URL: `https://aistoryhub.co/api/v1`
- URL: `https://aistoryhub.co/api/v1/voiceprints/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

The voiceprint.

- Voiceprint
  - `id` string, uuid
  - `name` string
  - `description` string, nullable
  - `is_default` boolean
  - `voice_fingerprint` string, nullable: Freeform notes distilling this voice's signature quirks.
  - `exemplar_prose` string, nullable: A pasted passage exemplifying this voice.
  - `dials` VoiceDials: The 33 Style Lab dials, each 0-100. Unspecified dials default to 50 (neutral) on create.
    - `technical_influence` integer
    - `emotional_directness` integer
    - `sentence_complexity` integer
    - `metaphor_density` integer
    - `cynicism_hope` integer: 0 = cynical, 100 = hopeful.
    - `pacing` integer: 0 = slow/deliberate, 100 = fast/propulsive.
    - `action_heavy_opening` integer
    - `paragraph_length` integer
    - `dialogue_ratio` integer
    - `time_linearity` integer: 0 = fragmented/nonlinear, 100 = strictly linear.
    - `visual_emphasis` integer
    - `physical_detail_level` integer
    - `setting_detail` integer
    - `interiority_access` integer
    - `narrator_presence` integer
    - `humor_level` integer
    - `profanity_level` integer
    - `vocabulary_register` integer: 0 = plain/colloquial, 100 = elevated/literary.
    - `tactile_emphasis` integer
    - `auditory_emphasis` integer
    - `olfactory_emphasis` integer
    - `body_awareness` integer
    - `temperature_texture` integer
    - `fragmentation` integer
    - `repetition_effect` integer
    - `time_dilation` integer
    - `technical_accuracy` integer
    - `systemic_focus` integer: 0 = individual-focused, 100 = systems/institution-focused.
    - `ambiguity` integer: 0 = resolved/clear, 100 = deliberately ambiguous.
    - `power_dynamics_visibility` integer
    - `numeric_density` integer
    - `acronym_tolerance` integer
    - `mechanism_surface` integer
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `401`: Missing, malformed, invalid, revoked, or expired token.
- `403`: The token lacks the scope this endpoint requires.
- `404`: The resource does not exist or you do not own it.
- `429`: Too many requests. Retry after the delay in the `Retry-After` header.

---

[API](https://skmtc.dev/aistoryhub/apis/aistoryhub-api.md) · [All operations](https://skmtc.dev/aistoryhub/apis/aistoryhub-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aistoryhub/apis/aistoryhub-api/revisions/0cfd2c14ae12?raw)