Skip to main content
GET
/
api
/
v1
/
projects
/
{projectId}
/
chapters
List Chapters
curl --request GET \
  --url https://api.example.com/api/v1/projects/{projectId}/chapters \
  --header 'Authorization: <authorization>'
{
  "project_id": "<string>",
  "chapters": [
    {}
  ]
}

​
Overview

Retrieve all chapters for a specific project.

​
Request

​
Path Parameters

​
projectId
string
required
The project ID

​
Headers

​
Authorization
string
required
Bearer token with your API key

​
Response

​
project_id
string
The project ID
​
chapters
array
Array of chapter objects

​
Examples

curl https://api.babou.ai/api/v1/projects/prj_abc123xyz/chapters \
  -H "Authorization: Bearer $BABOU_API_KEY"

​
Response Example

{
  "project_id": "prj_abc123xyz",
  "chapters": [
    {
      "id": "cht_def456uvw",
      "project_id": "prj_abc123xyz",
      "name": "Introduction",
      "duration": 30,
      "created_at": "2025-12-02T10:01:00Z",
      "status": "ready",
      "prompt_count": 2
    },
    {
      "id": "cht_ghi789rst",
      "project_id": "prj_abc123xyz",
      "name": "Main Content",
      "duration": 60,
      "created_at": "2025-12-02T10:02:00Z",
      "status": "processing",
      "prompt_count": 1
    }
  ]
}
The status field is derived from chapter interactions and can be ready, processing, or error. The prompt_count field indicates how many prompts have been submitted to the chapter.

​
Next Steps

Get Chapter

Get detailed chapter information

Create Chapter

Add a new chapter