API ReferenceProjectsExports

Easy export of tasks and annotations

GET

If you have a large project it’s recommended to use export snapshots, this easy export endpoint might have timeouts.
Export annotated tasks as a file in a specific format. For example, to export JSON annotations for a project to a file called annotations.json, run the following from the command line:

$curl -X GET https://localhost:8080/api/projects/{id}/export?exportType=JSON -H 'Authorization: Token abc123' --output 'annotations.json'

To export all tasks, including skipped tasks and others without annotations, run the following from the command line:

$curl -X GET https://localhost:8080/api/projects/{id}/export?exportType=JSON&download_all_tasks=true -H 'Authorization: Token abc123' --output 'annotations.json'

To export specific tasks with IDs of 123 and 345, run the following from the command line:

$curl -X GET https://localhost:8080/api/projects/{id}/export?ids[]=123\&ids[]=345 -H 'Authorization: Token abc123' --output 'annotations.json'

You must provide a project ID. The project ID can be found in the URL when viewing the project in Label Studio, or you can retrieve all project IDs using List all projects.

Path parameters

idintegerRequired
A unique integer value identifying this project.

Query parameters

export_typestringOptional
Selected export format (JSON by default)
download_all_tasksstringOptional
If true, download all tasks regardless of status. If false, download only annotated tasks.
download_resourcesbooleanOptional
If true, download all resource files such as images, audio, and others relevant to the tasks.
idsintegerOptional
Specify a list of task IDs to retrieve only the details for those tasks.

Response

This endpoint returns a file.