---
title: "Reads all Projects"
method: GET
path: "/api/2026-07-01/resources/project_management/projects"
tags: ["ProjectManagement > Project"]
---

# Reads all Projects

`GET /api/2026-07-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.

## Query parameters

- `ids[]` string[] — Retrieve only the projects that matches the ids provided in the request.
- `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` string — Retrieve only the projects that are related to the legal entity passed in the request.
- `client_ids[]` string[] — Retrieve only the projects that are related to the clients passed in the request, refers to finance/contacts.
- `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 `200`

OK

- object
  - `data` ProjectManagementProject[]
    - `id` string, required — The id of the project
    - `name` string, required — The name of the project
    - `code` string — The code of the project
    - `description` string — The description of the project
    - `start_date` string — The start date of the project
    - `due_date` string — The end date of the project
    - `status` 'active' | 'closed' | 'draft' | 'processing', required — The lifecycle status of the project (whether it is still running and can take new charges)
    - `employees_assignment` 'manual' | 'company', required — How employees get access to the project — `manual` (hand-picked members) or `company` (everyone in the company)
    - `inputed_minutes` integer — The total minutes tracked in the project (if requested)
    - `is_billable` boolean, required — Whether the project's costs can be billed (recharged) to a client
    - `fixed_cost_cents` integer — Total fixed costs in cents
    - `labor_cost_cents` integer — Total labor costs in cents
    - `legal_entity_id` string, required — The legal entity id of the project
    - `spending_cost_cents` integer — Total spending costs in cents
    - `client_id` string — The client of the project, refers to finance/contacts.
    - `total_cost_cents` integer — Total Cost in cents
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/factorialhr/factorial-api/revisions/1a6bffb20f7d/schema)