---
title: "List Chapters"
method: GET
path: "/v1/studio/projects/{project_id}/chapters"
tags: ["studio"]
---

# List Chapters

`GET /v1/studio/projects/{project_id}/chapters`

Returns a list of a Studio project's chapters.

## Path parameters

- `project_id` string, required — The ID of the Studio project.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetChaptersResponseModel
  - `chapters` ChapterResponseModel[], required
    - `chapter_id` string, required — The ID of the chapter.
    - `name` string, required — The name of the chapter.
    - `last_conversion_date_unix` integer, nullable — The last conversion date of the chapter.
    - `conversion_progress` number, nullable — The conversion progress of the chapter.
    - `can_be_downloaded` boolean, required — Whether the chapter can be downloaded.
    - `state` 'default' | 'converting', required — The state of the chapter.
    - `has_video` boolean, nullable — Whether the chapter has a video.
    - `has_visual_content` boolean, nullable — Whether the chapter has any visual content (video, image, or text clips).
    - `voice_ids` string[], nullable — List of voice ids used by the chapter
    - `statistics` ChapterStatisticsResponseModel
      - `characters_unconverted` integer, required — The number of unconverted characters.
      - `characters_converted` integer, required — The number of converted characters.
      - `paragraphs_converted` integer, required — The number of converted paragraphs.
      - `paragraphs_unconverted` integer, required — The number of unconverted paragraphs.
      - `credits_needed_to_convert` integer, nullable — The number of credits needed to convert the remaining paragraphs.
      - `voice_statistics` VoiceStatisticsResponseModel[], nullable — Per-voice breakdown of character counts.
        - `project_voice_ref_id` string, required — The project voice reference ID.
        - `characters_unconverted` integer, required — The number of unconverted characters for this voice.
        - `characters_converted` integer, required — The number of converted characters for this voice.
        - `credits_needed_to_convert` integer, nullable — The number of credits needed to convert the remaining audio for this voice.
        - `voice_id` string, required — The voice ID.
    - `last_conversion_error` string, nullable — The last conversion error of the chapter.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/db6eec599cbe/schema)