ProjectManagement > ProjectTask

Reads all Project tasks

Changed on
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.

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
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: project_management_projects
    • or API key in header x-api-key

Query parameters

ids[]string[] required

Retrieve only the projects tasks that matches the ids passed in the request.

[
  "314159",
  "271828"
]
project_ids[]string[] required

Retrieve only the projects tasks from the projects that matched the ids passed in the request.

[
  "314159",
  "271828"
]
subproject_ids[]string[] required

Retrieve only the projects tasks from the subprojects that matched the ids passed in the request.

[
  "314159",
  "271828"
]
task_ids[]string[]
completedboolean required

Retrieve only the projects tasks with the status completed.

Example:true
overdueboolean required

Retrieve only the projects tasks that are overdue.

Example:true
searchstring required

Retrieve only the projects tasks that their name match with the content passed as argument.

Example:Project Name
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.

Example:due_in_future
client_ids[]string[] required

Retrieve only the projects tasks from the clients that matched the ids passed in the request.

[
  "314159",
  "271828"
]

Response

OK

Example response

{
  "data": [
    {
      "id": "789",
      "project_id": "123",
      "subproject_id": "456",
      "task_id": "780",
      "follow_up": true
    }
  ]
}

Changes