Reads all Projects

get

https://api.factorialhr.com/api/2026-04-01/resources/project_management/projects

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

If the user has the team_leader permission, he will only be able to read the projects that he is the team leader.
If the user has the reportees permission, he will only be able to read the projects that he is the team leader or the projects that he is a team member.
If the user has everyone permission, he will be able to read all projects.
If the user has the owned permission, he will only be able to read the projects that he is the assigned.

Is it related to other entities? A project is always related to a company, so you can use the query params to list only the projects that are related to a specific company. ###### Who can use it? Only companies who have enabled the `projects_management` feature and users with the permission of read projects.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

ids[]

array of integers

Retrieve only the projects that matches the ids provided in the request.

ids[]

name

string

Retrieve only the projects that match the name passed in the request. (deprecated)

name_or_code

string

Retrieve only the projects that match the name or code passed in the request.

include_inputed_minutes

boolean

required

If true we will perform the minutes calculations and will be return the total inputed_minutes. If false, 0 will be returned and no minutes calculations will be performed.

include_costs

boolean

If true we will perform the costs calculations and will be return the total cost. If false, 0 will be returned and no costs calculations will be performed.

updated_after

string

Retrieve only the projects that were created or updated after the date provided in the request.

legal_entity_id

integer

Retrieve only the projects that are related to the legal entity passed in the request.

client_ids[]

array of integers

Retrieve only the projects that are related to the clients passed in the request, refers to finance/contacts.

client_ids[]

no_clients

boolean

Retrieve only the projects that are not related to any client, refers to finance/contacts.

total_currency

string

Retrieve only the projects that have the total cost in the currency passed in the request.

Response

200OK