Get Project By Id

GET

/v1/projects/:project_id

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

Path parameters

project_idstringRequired

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_idstring

namestring

create_date_unixinteger

default_title_voice_idstring

default_paragraph_voice_idstring

default_model_idstring

can_be_downloadedboolean

volume_normalizationboolean

stateenum

Allowed values: creatingdefaultconvertingin_queue

access_levelenum

Allowed values: admineditorviewer

quality_check_onboolean

quality_check_on_when_bulk_convertboolean

quality_presetenum

Allowed values: standardhighhighestultraultra_lossless

chapterslist of objects

pronunciation_dictionary_versionslist of objects

apply_text_normalizationenum

Allowed values: autoonoffapply_english

experimentalmap from strings to any

last_conversion_date_unixintegerOptional

titlestringOptional

authorstringOptional

descriptionstringOptional

genreslist of stringsOptional

cover_image_urlstringOptional

target_audienceenumOptional

Allowed values: childrenyoung adultadultall ages

languagestringOptional

content_typestringOptional

original_publication_datestringOptional

mature_contentbooleanOptional

isbn_numberstringOptional

fiction"fiction" or "non-fiction"Optional

Allowed values: fictionnon-fiction

creation_metaobjectOptional

GET

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

200Retrieved

1 {
2   "project_id": "project_id",
3   "name": "name",
4   "create_date_unix": 1,
5   "default_title_voice_id": "default_title_voice_id",
6   "default_paragraph_voice_id": "default_paragraph_voice_id",
7   "default_model_id": "default_model_id",
8   "can_be_downloaded": true,
9   "volume_normalization": true,
10   "state": "creating",
11   "access_level": "admin",
12   "quality_check_on": true,
13   "quality_check_on_when_bulk_convert": true,
14   "quality_preset": "standard",
15   "chapters": [
16     {
17       "chapter_id": "chapter_id",
18       "name": "name",
19       "can_be_downloaded": true,
20       "state": "default",
21       "last_conversion_date_unix": 1,
22       "conversion_progress": 1.1,
23       "statistics": {
24         "characters_unconverted": 1,
25         "characters_converted": 1,
26         "paragraphs_converted": 1,
27         "paragraphs_unconverted": 1
28       },
29       "last_conversion_error": "last_conversion_error"
30     }
31   ],
32   "pronunciation_dictionary_versions": [
33     {
34       "version_id": "version_id",
35       "pronunciation_dictionary_id": "pronunciation_dictionary_id",
36       "dictionary_name": "dictionary_name",
37       "version_name": "version_name",
38       "created_by": "created_by",
39       "creation_time_unix": 1
40     }
41   ],
42   "apply_text_normalization": "auto",
43   "experimental": {
44     "key": "value"
45   },
46   "last_conversion_date_unix": 1,
47   "title": "title",
48   "author": "author",
49   "description": "description",
50   "genres": [
51     "genres"
52   ],
53   "cover_image_url": "cover_image_url",
54   "target_audience": "children",
55   "language": "language",
56   "content_type": "content_type",
57   "original_publication_date": "original_publication_date",
58   "mature_content": true,
59   "isbn_number": "isbn_number",
60   "fiction": "fiction",
61   "creation_meta": {
62     "creation_progress": 1.1,
63     "status": "pending",
64     "type": "blank"
65   }
66 }

Add Project

Up Next

Built with

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

1	{
2	"project_id": "project_id",
3	"name": "name",
4	"create_date_unix": 1,
5	"default_title_voice_id": "default_title_voice_id",
6	"default_paragraph_voice_id": "default_paragraph_voice_id",
7	"default_model_id": "default_model_id",
8	"can_be_downloaded": true,
9	"volume_normalization": true,
10	"state": "creating",
11	"access_level": "admin",
12	"quality_check_on": true,
13	"quality_check_on_when_bulk_convert": true,
14	"quality_preset": "standard",
15	"chapters": [
16	{
17	"chapter_id": "chapter_id",
18	"name": "name",
19	"can_be_downloaded": true,
20	"state": "default",
21	"last_conversion_date_unix": 1,
22	"conversion_progress": 1.1,
23	"statistics": {
24	"characters_unconverted": 1,
25	"characters_converted": 1,
26	"paragraphs_converted": 1,
27	"paragraphs_unconverted": 1
28	},
29	"last_conversion_error": "last_conversion_error"
30	}
31	],
32	"pronunciation_dictionary_versions": [
33	{
34	"version_id": "version_id",
35	"pronunciation_dictionary_id": "pronunciation_dictionary_id",
36	"dictionary_name": "dictionary_name",
37	"version_name": "version_name",
38	"created_by": "created_by",
39	"creation_time_unix": 1
40	}
41	],
42	"apply_text_normalization": "auto",
43	"experimental": {
44	"key": "value"
45	},
46	"last_conversion_date_unix": 1,
47	"title": "title",
48	"author": "author",
49	"description": "description",
50	"genres": [
51	"genres"
52	],
53	"cover_image_url": "cover_image_url",
54	"target_audience": "children",
55	"language": "language",
56	"content_type": "content_type",
57	"original_publication_date": "original_publication_date",
58	"mature_content": true,
59	"isbn_number": "isbn_number",
60	"fiction": "fiction",
61	"creation_meta": {
62	"creation_progress": 1.1,
63	"status": "pending",
64	"type": "blank"
65	}
66	}