Skip to main content
GET
/
v1
/
projects
/
{project_id}
Python
from elevenlabs import ElevenLabs

client = ElevenLabs(
    api_key="YOUR_API_KEY",
)
client.projects.get(
    project_id="21m00Tcm4TlvDq8ikWAM",
)
{
  "project_id": "<string>",
  "name": "<string>",
  "create_date_unix": 123,
  "default_title_voice_id": "<string>",
  "default_paragraph_voice_id": "<string>",
  "default_model_id": "<string>",
  "last_conversion_date_unix": 123,
  "can_be_downloaded": true,
  "title": "<string>",
  "author": "<string>",
  "description": "<string>",
  "genres": [
    "<string>"
  ],
  "cover_image_url": "<string>",
  "target_audience": "children",
  "language": "<string>",
  "content_type": "<string>",
  "original_publication_date": "<string>",
  "mature_content": true,
  "isbn_number": "<string>",
  "volume_normalization": true,
  "state": "creating",
  "access_level": "admin",
  "fiction": "fiction",
  "quality_check_on": true,
  "quality_check_on_when_bulk_convert": true,
  "creation_meta": {
    "creation_progress": 123,
    "status": "pending",
    "type": "blank"
  },
  "quality_preset": "standard",
  "chapters": [
    {
      "chapter_id": "<string>",
      "name": "<string>",
      "last_conversion_date_unix": 123,
      "conversion_progress": 123,
      "can_be_downloaded": true,
      "state": "default",
      "statistics": {
        "characters_unconverted": 123,
        "characters_converted": 123,
        "paragraphs_converted": 123,
        "paragraphs_unconverted": 123
      },
      "last_conversion_error": "<string>"
    }
  ],
  "pronunciation_dictionary_versions": [
    {
      "version_id": "<string>",
      "pronunciation_dictionary_id": "<string>",
      "dictionary_name": "<string>",
      "version_name": "<string>",
      "created_by": "<string>",
      "creation_time_unix": 123
    }
  ],
  "apply_text_normalization": "auto",
  "experimental": {}
}
Projects API avaliable upon request. To get access, contact sales.

Headers

​
xi-api-key
string

Your API key. This is required by most endpoints to access our API programatically. You can view your xi-api-key using the 'Profile' tab on the website.

Path Parameters

​
project_id
string
required

The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects.

Response

Successful Response

​
project_id
string
required
​
name
string
required
​
create_date_unix
integer
required
​
default_title_voice_id
string
required
​
default_paragraph_voice_id
string
required
​
default_model_id
string
required
​
can_be_downloaded
boolean
required
​
volume_normalization
boolean
required
​
state
enum<string>
required
Available options:
creating,
default,
converting,
in_queue
​
access_level
enum<string>
required
Available options:
admin,
editor,
viewer
​
quality_check_on
boolean
required
​
quality_check_on_when_bulk_convert
boolean
required
​
quality_preset
enum<string>
required
Available options:
standard,
high,
highest,
ultra,
ultra_lossless
​
chapters
ChapterResponseModel · object[]
required
​
pronunciation_dictionary_versions
PronunciationDictionaryVersionResponseModel · object[]
required
​
apply_text_normalization
enum<string>
required
Available options:
auto,
on,
off,
apply_english
​
experimental
object
required
​
last_conversion_date_unix
integer
​
title
string
​
author
string
​
description
string
​
genres
string[]
​
cover_image_url
string
​
target_audience
enum<string>
Available options:
children,
young adult,
adult,
all ages
​
language
string
​
content_type
string
​
original_publication_date
string
​
mature_content
boolean
​
isbn_number
string
​
fiction
enum<string>
Available options:
fiction,
non-fiction
​
creation_meta
object