---
title: "List project tasks"
method: GET
path: "/api/projects/{id}/tasks/"
tags: ["Projects"]
---

# List project tasks

`GET /api/projects/{id}/tasks/`

Retrieve a paginated list of tasks for a specific project. For example, use the following cURL command:
            ```bash
            curl -X GET http://localhost:8000/api/projects/{id}/tasks/?page=1&page_size=10 -H 'Authorization: Token abc123'
            ```

## Path parameters

- `id` integer, required

## Query parameters

- `ordering` string
- `page` integer
- `page_size` integer

## Response `200`

- TaskSimple[]
  - `annotations` Annotation[], required
    - `bulk_created` boolean, nullable — Annotation was created in bulk mode
    - `completed_by` integer
    - `created_ago` string, required — Time delta from creation time
    - `created_at` string, date-time, required — Creation time
    - `created_username` string, required — Username string
    - `draft_created_at` string, date-time, nullable — Draft creation time
    - `ground_truth` boolean — This annotation is a Ground Truth (ground_truth)
    - `id` integer, required
    - `import_id` integer, nullable — Original annotation ID that was at the import step or NULL if this annotation wasn't imported
    - `last_action` 'prediction' | 'propagated_annotation' | 'imported' | 'submitted' | 'updated' | 'skipped' | 'accepted' | 'rejected' | 'fixed_and_accepted' | 'deleted_review' — * `prediction` - Created from prediction * `propagated_annotation` - Created from another annotation * `imported` - Imported * `submitted` - Submitted * `updated` - Updated * `skipped` - Skipped * `accepted` - Accepted * `rejected` - Rejected * `fixed_and_accepted` - Fixed and accepted * `deleted_review` - Deleted review
    - `last_created_by` integer, nullable — User who created the last annotation history item
    - `lead_time` number, double, nullable — How much time it took to annotate the task
    - `parent_annotation` integer, nullable — Points to the parent annotation from which this annotation was created
    - `parent_prediction` integer, nullable — Points to the prediction from which this annotation was created
    - `project` integer, nullable — Project ID for this annotation
    - `result` object[] — List of annotation results for the task
    - `state` string, required
    - `task` integer, nullable — Corresponding task for this annotation
    - `updated_at` string, date-time, required — Last updated time
    - `updated_by` integer, nullable — Last user who updated this annotation
    - `was_cancelled` boolean — User skipped the task
  - `cancelled_annotations` integer — Number of total cancelled annotations for the current task
  - `comment_authors` integer[] — Users who wrote comments
  - `comment_count` integer — Number of comments in the task including all annotations
  - `created_at` string, date-time, required — Time a task was created
  - `data` unknown, required
  - `file_upload` integer, nullable — Uploaded file used as data source for this task
  - `id` integer, required
  - `inner_id` integer, nullable — Internal task ID in the project, starts with 1
  - `is_labeled` boolean — True if the number of annotations for this task is greater than or equal to the number of maximum_completions for the project
  - `last_comment_updated_at` string, date-time, nullable — When the last comment was updated
  - `meta` unknown
  - `overlap` integer — Number of distinct annotators that processed the current task
  - `predictions` Prediction[], required
    - `cluster` integer, nullable — Cluster for the current prediction
    - `created_ago` string, required — Delta time from creation time
    - `created_at` string, date-time, required
    - `id` integer, required
    - `mislabeling` number, double — Related task mislabeling score
    - `model` integer, nullable — An ML Backend instance that created the prediction.
    - `model_run` integer, nullable — A run of a ModelVersion that created the prediction.
    - `model_version` string — Model version - tag for predictions that can be used to filter tasks in Data Manager, as well as select specific model version for showing preannotations in the labeling interface
    - `neighbors` unknown
    - `project` integer, nullable
    - `result` object[], required — List of prediction results for the task
    - `score` number, double, nullable — Prediction score
    - `task` integer, required
    - `updated_at` string, date-time, required
  - `project` integer, nullable — Project ID for this task
  - `total_annotations` integer — Number of total annotations for the current task except cancelled annotations
  - `total_predictions` integer — Number of total predictions for the current task
  - `unresolved_comment_count` integer — Number of unresolved comments in the task including all annotations
  - `updated_at` string, date-time, required — Last time a task was updated
  - `updated_by` integer, nullable — Last annotator or reviewer who updated this task

---

[API](https://skmtc.net/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.net/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/versions/1b113b8df950/schema)