---
title: "Reads all Project tasks"
method: GET
path: "/api/2026-10-01/resources/project_management/project_tasks"
tags: ["ProjectManagement > ProjectTask"]
---

# Reads all Project tasks

`GET /api/2026-10-01/resources/project_management/project_tasks`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/project_management/project_tasks`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `project_management_projects`
  - API key in header `x-api-key`

###### **What does it do?**
This reads the data of projects tasks, and retrieves the information based on permissions:

  - If the user can see all company projects for everybody, the endpoint will return a list with the tasks from the related projects.
  - If the user can create projects for everybody, the endpoint will return a list with the tasks from the related projects.
  - If the user has any role (editor or owner) on the project, the endpoint will return a list with the tasks from the related projects where the user has that role.
  - If those conditions are not matched, the endpoint will return an empty list.

###### **What params does it accept?**

  - `ids`: retrieve only the projects tasks that matches the ids passed in the request.
  - `project_ids`: retrieve only the projects tasks from the projects that matched the ids passed in the request.
  - `subproject_ids`: retrieve only the projects tasks from the subprojects that matched the ids passed in the request.
  - `completed`: boolean - retrieve only the projects tasks with the status completed.
  - `overdue`: boolean - retrieve only the projects tasks that are overdue.
  - `search`:  retrieve only the projects tasks that their name match with the content passed as argument.
  - `due_status`: retrieve only the project tasks that their due status match with the content passed as argument.
  - `client_ids`: retrieve only the projects tasks from the clients that matched the ids passed in the request.

###### **Who can use it?**

  Only companies who have enabled the `projects_management` feature and users with the permission of read projects.

## Query parameters

- `ids[]` string[], required: Retrieve only the projects tasks that matches the ids passed in the request.
- `project_ids[]` string[], required: Retrieve only the projects tasks from the projects that matched the ids passed in the request.
- `subproject_ids[]` string[], required: Retrieve only the projects tasks from the subprojects that matched the ids passed in the request.
- `task_ids[]` string[]
- `completed` boolean, required: Retrieve only the projects tasks with the status completed.
- `overdue` boolean, required: Retrieve only the projects tasks that are overdue.
- `search` string, required: Retrieve only the projects tasks that their name match with the content passed as argument.
- `due_status` 'no_due' | 'due_today' | 'over_due' | 'due_in_future', required: Retrieve only the project tasks that their due status match with the content passed as argument.
- `client_ids[]` string[], required: Retrieve only the projects tasks from the clients that matched the ids passed in the request.

## Response `200`

OK

- object
  - `data` ProjectManagementProjectTask[]
    - `id` string, required
    - `project_id` string, required: The ID of the project linked to the project task
    - `subproject_id` string: The ID of the subproject linked to the project task
    - `task_id` string, required: The ID of the task linked to the project task
    - `follow_up` boolean, required: If true, status changes related to the project will notify the author
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/project_management/project_tasks/get.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)