Get project by ID | API Reference

Retrieve information about a project by project ID.

Authentication

AuthorizationToken

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example:

curl https://label-studio-host/api/projects -H “Authorization: Token [your-token]”

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Path parameters

idintegerRequired

Query parameters

members_limitintegerOptionalDefaults to 10

Maximum number of members to return

Response

Project information. Not all fields are available for all roles.

allow_streambooleanRead-only

assignment_settingsobject

config_has_control_tagsbooleanRead-only

Flag to detect is project ready for labeling

config_suitable_for_bulk_annotationbooleanRead-only

Flag to detect is project ready for bulk annotation

created_atdatetimeRead-only

data_typesmap from strings to any or nullRead-only

finished_task_numberintegerRead-only

Finished tasks

ground_truth_numberintegerRead-only

Honeypot annotation number in project

idintegerRead-only

is_dimensions_enabledstringRead-only

membersstringRead-only

members_countintegerRead-only

num_tasks_with_annotationsintegerRead-only

parsed_label_configmap from strings to anyRead-only

JSON-formatted labeling configuration

promptsstringRead-only

queue_doneintegerRead-only

queue_leftintegerRead-only

queue_totalintegerRead-only

readybooleanRead-only

rejectedintegerRead-only

review_settingsobject

review_total_tasksintegerRead-only

reviewed_numberintegerRead-only

reviewer_queue_totalintegerRead-only

skipped_annotations_numberintegerRead-only

start_training_on_annotation_updatebooleanRead-only

Start model training after any annotations are submitted or updated

statestringRead-only

task_numberintegerRead-only

Total task number in project

total_annotations_numberintegerRead-only

total_predictions_numberinteger or nullRead-only

useful_annotation_numberinteger or nullRead-only

workspacestringRead-only

workspace_titlestringRead-only

agreement_methodologyenum

Methodology (Consensus / Pairwise Averaging)

consensus - Consensus
pairwise - Pairwise Averaging

Methodology (Consensus / Pairwise Averaging) * `consensus` - Consensus * `pairwise` - Pairwise Averaging

Allowed values:

agreement_thresholdstring or nullformat: "decimal"

Agreement threshold

annotation_limit_countinteger or null>=1

Limit by number of tasks

annotation_limit_percentstring or nullformat: "decimal"

Limit by percentage of tasks

annotator_evaluation_continuous_tasksinteger>=0Defaults to 0

Continuous Evaluation: Required tasks

annotator_evaluation_enabledboolean

Evaluate all annotators against ground truth

annotator_evaluation_minimum_scorestring or nullformat: "decimal"Defaults to 95.00

Score required to pass evaluation

annotator_evaluation_minimum_tasksinteger or null>=0Defaults to 10

Number of tasks for evaluation

annotator_evaluation_onboarding_tasksinteger>=0Defaults to 0

Onboarding Evaluation: Required tasks

colorstring or null<=16 characters

Color

comment_classification_configstring

control_weightsmap from strings to objects or null

Dict of weights for each control tag in metric calculation. Keys are control tag names from the labeling config. At least one tag must have a non-zero overall weight.

created_byobject

Project owner

custom_scriptstring

Plugins

custom_task_lock_ttlinteger or null1-86400

Task reservation time. TTL in seconds (UI displays and edits this value in minutes).

descriptionstring or null

Description

duplication_donebooleanDefaults to false

duplication_statusstring

enable_empty_annotationboolean

Allow empty annotations

evaluate_predictions_automaticallyboolean

Retrieve and display predictions when loading a task

expert_instructionstring or null

Instructions

is_draftboolean

Whether or not the project is in the middle of being created

is_publishedboolean

Whether or not the project is published to annotators

label_configstring or null

Labeling Configuration

max_additional_annotators_assignableinteger or null

Maximum additional annotators

maximum_annotationsinteger-2147483648-2147483647

Annotations per task

min_annotations_to_start_traininginteger-2147483648-2147483647

Minimum number of completed tasks after which model training is started

model_versionstring or null

Machine learning model version

organizationinteger or null

overlap_cohort_percentageinteger-2147483648-2147483647

Annotations per task coverage

pause_on_failed_annotator_evaluationboolean or nullDefaults to false

Pause annotator on failed evaluation

pinned_atdatetime or null

Pinned date and time

require_comment_on_skipbooleanDefaults to false

Require comment to skip

reveal_preannotations_interactivelyboolean

Reveal pre-annotations interactively

samplingenum or null

Sequential sampling - Tasks are ordered by Data manager ordering
Uniform sampling - Tasks are chosen randomly
Uncertainty sampling - Tasks are chosen according to model uncertainty scores (active learning mode)

* `Sequential sampling` - Tasks are ordered by Data manager ordering * `Uniform sampling` - Tasks are chosen randomly * `Uncertainty sampling` - Tasks are chosen according to model uncertainty scores (active learning mode)

Allowed values:

show_annotation_historyboolean

Show Data Manager to Annotators

show_collab_predictionsboolean

Use predictions to pre-label Tasks

show_instructionboolean

Show instructions before labeling

show_overlap_firstboolean

Show tasks with overlap first

show_skip_buttonboolean

Allow skipping tasks

show_unused_data_columns_to_annotatorsboolean or null

Show only columns used in labeling configuration to Annotators. API uses inverse field semantics here: set false to show only used columns, set true to show all task.data columns.

skip_queueenum or null

REQUEUE_FOR_ME - Requeue for me
REQUEUE_FOR_OTHERS - Requeue for others
IGNORE_SKIPPED - Ignore skipped

* `REQUEUE_FOR_ME` - Requeue for me * `REQUEUE_FOR_OTHERS` - Requeue for others * `IGNORE_SKIPPED` - Ignore skipped

Allowed values:

strict_task_overlapbooleanDefaults to true

Enforce strict overlap limit

task_data_loginstring or null<=256 characters

task_data_passwordstring or null<=256 characters

Password

titlestring or null3-50 characters

Project Name

show_ground_truth_firstbooleanDeprecated

Onboarding mode (true): show ground truth tasks first in the labeling stream

1	{
2	"allow_stream": true,
3	"assignment_settings": {
4	"id": 1,
5	"label_stream_task_distribution": "auto_distribution",
6	"project": 1
7	},
8	"config_has_control_tags": true,
9	"config_suitable_for_bulk_annotation": true,
10	"created_at": "2024-01-15T09:30:00Z",
11	"data_types": {
12	"image": true,
13	"text": false
14	},
15	"finished_task_number": 150,
16	"ground_truth_number": 10,
17	"id": 1,
18	"is_dimensions_enabled": "enabled",
19	"members": "Alice, Bob, Charlie",
20	"members_count": 3,
21	"num_tasks_with_annotations": 140,
22	"parsed_label_config": {
23	"views": [
24	{
25	"type": "Text",
26	"name": "text",
27	"value": "$text"
28	}
29	]
30	},
31	"prompts": "Annotate the sentiment of the text.",
32	"queue_done": 120,
33	"queue_left": 30,
34	"queue_total": 150,
35	"ready": true,
36	"rejected": 5,
37	"review_settings": {
38	"id": 1,
39	"requeue_rejected_tasks_to_annotator": true,
40	"anonymize_annotations": true,
41	"instruction": "Review annotations carefully for quality.",
42	"only_finished_tasks": true,
43	"project": 1,
44	"requeue_rejected_tasks_mode": "requeue",
45	"require_comment_on_reject": true,
46	"review_criteria": "all",
47	"review_only_manual_assignments": true,
48	"review_task_limit_percent": "50.00",
49	"sampling": "task_id",
50	"show_agreement_to_reviewers": true,
51	"show_data_manager_to_reviewers": true,
52	"show_instruction": true,
53	"show_unused_data_columns_to_reviewers": true
54	},
55	"review_total_tasks": 100,
56	"reviewed_number": 80,
57	"reviewer_queue_total": 20,
58	"skipped_annotations_number": 3,
59	"start_training_on_annotation_update": true,
60	"state": "active",
61	"task_number": 200,
62	"total_annotations_number": 450,
63	"total_predictions_number": 120,
64	"useful_annotation_number": 430,
65	"workspace": "default",
66	"workspace_title": "Default Workspace",
67	"agreement_methodology": "consensus",
68	"agreement_threshold": "0.85",
69	"annotation_limit_count": 100,
70	"annotation_limit_percent": "75.00",
71	"annotator_evaluation_continuous_tasks": 5,
72	"annotator_evaluation_enabled": true,
73	"annotator_evaluation_minimum_score": "95.00",
74	"annotator_evaluation_minimum_tasks": 10,
75	"annotator_evaluation_onboarding_tasks": 3,
76	"color": "#4A90E2",
77	"comment_classification_config": "{\"type\": \"text\", \"labels\": [\"Spam\", \"Offensive\"]}",
78	"control_weights": {},
79	"created_by": {
80	"avatar": "https://labelstud.io/static/avatar1.png",
81	"id": 42,
82	"username": "janedoe",
83	"email": "jane.doe@example.com",
84	"first_name": "Jane",
85	"last_name": "Doe"
86	},
87	"custom_script": "function customValidation() { return true; }",
88	"custom_task_lock_ttl": 3600,
89	"description": "Project for annotating customer support tickets",
90	"duplication_done": false,
91	"duplication_status": "pending",
92	"enable_empty_annotation": true,
93	"evaluate_predictions_automatically": true,
94	"expert_instruction": "Please follow the guidelines carefully when annotating.",
95	"is_draft": false,
96	"is_published": true,
97	"label_config": "<View><Text name=\"text\" value=\"$text\"/></View>",
98	"max_additional_annotators_assignable": 5,
99	"maximum_annotations": 3,
100	"min_annotations_to_start_training": 50,
101	"model_version": "v1.2.3",
102	"organization": 7,
103	"overlap_cohort_percentage": 20,
104	"pause_on_failed_annotator_evaluation": false,
105	"pinned_at": "2024-02-01T12:00:00Z",
106	"require_comment_on_skip": false,
107	"reveal_preannotations_interactively": true,
108	"sampling": "Sequential sampling",
109	"show_annotation_history": true,
110	"show_collab_predictions": true,
111	"show_instruction": true,
112	"show_overlap_first": true,
113	"show_skip_button": true,
114	"show_unused_data_columns_to_annotators": false,
115	"skip_queue": "REQUEUE_FOR_ME",
116	"strict_task_overlap": true,
117	"task_data_login": "annotator_user",
118	"task_data_password": "securepassword123",
119	"title": "Customer Support Ticket Annotation",
120	"show_ground_truth_first": true
121	}

1	curl http://localhost:8000/api/projects/1/ \
2	-H "Authorization: Token <api_key>" \
3	-H "Content-Type: application/json"