---
title: "Voice List"
method: GET
path: "/api/v2/voices"
tags: ["voices"]
---

# Voice List

`GET /api/v2/voices`

## Query parameters

- `limit` integer
- `offset` integer
- `visibility` VisibilityLevel[]
- `species` Species[]
- `gender` Gender[]
- `age_group` AgeGroup[]
- `pitch_group` PitchGroup[]
- `nationality` string[]
- `sort` 'default' | 'name' | 'pitch' | 'rating' | 'created_at' — An enumeration.
- `direction` 'asc' | 'desc' — An enumeration.

## Headers

- `x-csrf-token` string
- `api-key` string

## Cookies

- `session_id` string

## Response `200`

Successful Response

- VoiceListResponse
  - `list` VoicePublic[], required
    - `id` string, uuid4, required
    - `owner_id` string, uuid4, required
    - `name` string, required
    - `slug` string, required
    - `visibility` 'public' | 'paid' | 'private' | 'kids', required — An enumeration.
    - `species` 'human' | 'animal' | 'other' — An enumeration.
    - `artist` string
    - `verified_artist` boolean
    - `gender` 'male' | 'female' — An enumeration.
    - `pitch` number
    - `age_group` 'child' | 'young' | 'adult' | 'senior' — An enumeration.
    - `pitch_group` 'low' | 'mid' | 'high' — An enumeration.
    - `nationality` string
    - `image_url` string
    - `thumbnail_url` string
    - `description` string
    - `rating` integer, required
    - `active` boolean, required
    - `created_at` string, date-time, required
    - `favorite` boolean
    - `available` boolean
    - `accents` AccentPublic[], required
      - `id` string, uuid4, required
      - `is_default` boolean, required
      - `native` boolean, required
      - `info` AccentInfoCore, required
        - `name` string, required
        - `short_name` string, required
        - `locale` string, required
      - `tiers` SubscriptionTierCore[], required
        - `name` string, required
      - `available` boolean
      - `settings` AccentSettingsPublic
        - `favorite` boolean
        - `semitones_correction` number
    - `narration_styles` NarrationStylePublic[], required
      - `id` string, uuid4, required
      - `is_default` boolean, required
      - `info` NarrationStyleInfoCore, required
        - `name` string, required
      - `settings` NarrationStyleSettingPublic
        - `favorite` boolean
    - `tiers` SubscriptionTierCore[], required
      - `name` string, required
  - `pagination` Pagination, required
    - `count` integer, required
    - `limit` integer, required
    - `offset` integer, required

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

---

[API](https://skmtc.net/respeecher/apis/voice-markertplace-api.md) · [All operations](https://skmtc.net/respeecher/apis/voice-markertplace-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/respeecher/voice-markertplace-api/versions/dea31af89a85/schema)