Get Project By Id

Deprecated

GET

/v1/projects/:project_id

Returns information about a specific project. This endpoint returns more detailed information about a project than GET /v1/projects.

Path parameters

project_idstringRequired

The ID of the Studio project.

Response

Successful Response

project_idstring

The ID of the project.

namestring

The name of the project.

create_date_unixinteger

The creation date of the project.

default_title_voice_idstring

The default title voice ID.

default_paragraph_voice_idstring

The default paragraph voice ID.

default_model_idstring

The default model ID.

can_be_downloadedboolean

Whether the project can be downloaded.

volume_normalizationboolean

Whether the project uses volume normalization.

stateenum

Allowed values: creatingdefaultconvertingin_queue

The state of the project.

access_levelenum

Allowed values: admineditorviewer

The access level of the project.

quality_presetenum

Allowed values: standardhighhighestultraultra_lossless

The quality preset level of the project.

chapterslist of objects

List of chapters of the project and their metadata.

pronunciation_dictionary_versionslist of objects

List of pronunciation dictionary versions of the project and their metadata.

apply_text_normalizationenum

Allowed values: autoonoffapply_english

Whether text normalization is applied to the project.

experimentalmap from strings to any

Experimental features of the project.

quality_check_onbooleanDeprecated

Whether quality check is enabled for this project.

quality_check_on_when_bulk_convertbooleanDeprecated

Whether quality check is enabled on the project when bulk converting.

last_conversion_date_unixintegerOptional

The last conversion date of the project.

titlestringOptional

The title of the project.

authorstringOptional

The author of the project.

descriptionstringOptional

The description of the project.

genreslist of stringsOptional

List of genres of the project.

cover_image_urlstringOptional

The cover image URL of the project.

target_audienceenumOptional

Allowed values: childrenyoung adultadultall ages

The target audience of the project.

languagestringOptional

Two-letter language code (ISO 639-1) of the language of the project.

content_typestringOptional

The content type of the project, e.g. ‘Novel’ or ‘Short Story’

original_publication_datestringOptional

The original publication date of the project.

mature_contentbooleanOptional

Whether the project contains mature content.

isbn_numberstringOptional

The ISBN number of the project.

fictionenumOptional

Allowed values: fictionnon-fiction

Whether the project is fiction.

creation_metaobjectOptional

The creation meta of the project.

source_typeenumOptional

Allowed values: blankbookarticlegenfm

The source type of the project.

Errors

GET

1 curl https://api.elevenlabs.io/v1/projects/21m00Tcm4TlvDq8ikWAM \
2      -H "xi-api-key: <apiKey>"

200Retrieved

1 {
2   "project_id": "aw1NgEzBg83R7vgmiJt6",
3   "name": "My Project",
4   "create_date_unix": 1714204800,
5   "default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb",
6   "default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb",
7   "default_model_id": "eleven_multilingual_v2",
8   "can_be_downloaded": true,
9   "volume_normalization": true,
10   "state": "default",
11   "access_level": "viewer",
12   "quality_preset": "standard",
13   "chapters": [
14     {
15       "chapter_id": "aw1NgEzBg83R7vgmiJt6",
16       "name": "Chapter 1",
17       "can_be_downloaded": true,
18       "state": "converting",
19       "last_conversion_date_unix": 1714204800,
20       "conversion_progress": 0.5,
21       "statistics": {
22         "characters_unconverted": 1000,
23         "characters_converted": 500,
24         "paragraphs_converted": 20,
25         "paragraphs_unconverted": 10
26       },
27       "last_conversion_error": "Error message"
28     }
29   ],
30   "pronunciation_dictionary_versions": [
31     {
32       "version_id": "version_id",
33       "pronunciation_dictionary_id": "pronunciation_dictionary_id",
34       "dictionary_name": "dictionary_name",
35       "version_name": "version_name",
36       "created_by": "created_by",
37       "creation_time_unix": 1
38     }
39   ],
40   "apply_text_normalization": "auto",
41   "experimental": {
42     "key": "value"
43   },
44   "quality_check_on": false,
45   "quality_check_on_when_bulk_convert": false,
46   "last_conversion_date_unix": 1714204800,
47   "title": "My Project",
48   "author": "John Doe",
49   "description": "This is a description of my project.",
50   "genres": [
51     "Novel",
52     "Short Story"
53   ],
54   "cover_image_url": "https://example.com/cover.jpg",
55   "target_audience": "children",
56   "language": "en",
57   "content_type": "Novel",
58   "original_publication_date": "2025-01-01",
59   "mature_content": false,
60   "isbn_number": "978-90-274-3964-2",
61   "fiction": "fiction",
62   "creation_meta": {
63     "creation_progress": 0.5,
64     "status": "pending",
65     "type": "blank"
66   },
67   "source_type": "blank"
68 }

Edit Basic Project Info

Up Next

Built with

1	curl https://api.elevenlabs.io/v1/projects/21m00Tcm4TlvDq8ikWAM \
2	-H "xi-api-key: <apiKey>"

1	{
2	"project_id": "aw1NgEzBg83R7vgmiJt6",
3	"name": "My Project",
4	"create_date_unix": 1714204800,
5	"default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb",
6	"default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb",
7	"default_model_id": "eleven_multilingual_v2",
8	"can_be_downloaded": true,
9	"volume_normalization": true,
10	"state": "default",
11	"access_level": "viewer",
12	"quality_preset": "standard",
13	"chapters": [
14	{
15	"chapter_id": "aw1NgEzBg83R7vgmiJt6",
16	"name": "Chapter 1",
17	"can_be_downloaded": true,
18	"state": "converting",
19	"last_conversion_date_unix": 1714204800,
20	"conversion_progress": 0.5,
21	"statistics": {
22	"characters_unconverted": 1000,
23	"characters_converted": 500,
24	"paragraphs_converted": 20,
25	"paragraphs_unconverted": 10
26	},
27	"last_conversion_error": "Error message"
28	}
29	],
30	"pronunciation_dictionary_versions": [
31	{
32	"version_id": "version_id",
33	"pronunciation_dictionary_id": "pronunciation_dictionary_id",
34	"dictionary_name": "dictionary_name",
35	"version_name": "version_name",
36	"created_by": "created_by",
37	"creation_time_unix": 1
38	}
39	],
40	"apply_text_normalization": "auto",
41	"experimental": {
42	"key": "value"
43	},
44	"quality_check_on": false,
45	"quality_check_on_when_bulk_convert": false,
46	"last_conversion_date_unix": 1714204800,
47	"title": "My Project",
48	"author": "John Doe",
49	"description": "This is a description of my project.",
50	"genres": [
51	"Novel",
52	"Short Story"
53	],
54	"cover_image_url": "https://example.com/cover.jpg",
55	"target_audience": "children",
56	"language": "en",
57	"content_type": "Novel",
58	"original_publication_date": "2025-01-01",
59	"mature_content": false,
60	"isbn_number": "978-90-274-3964-2",
61	"fiction": "fiction",
62	"creation_meta": {
63	"creation_progress": 0.5,
64	"status": "pending",
65	"type": "blank"
66	},
67	"source_type": "blank"
68	}