---
title: "List all projects"
method: GET
path: "/projects"
tags: ["Projects"]
---

# List all projects

`GET /projects`

## Query parameters

- `projectName` ProjectName — unresolved $ref
- `status` Status — unresolved $ref
- `teamMembers` TeamMembers — unresolved $ref
- `teamMembersFiltering` TeamMembersFiltering — unresolved $ref
- `budgetFrom` BudgetFrom — unresolved $ref
- `budgetTo` BudgetTo — unresolved $ref

## Response `200`

Successful operation

- Project[]
  - `id` string, required
  - `name` string, required
  - `status` 'PLANNING' | 'ACTIVE' | 'COMPLETED' | 'ON_HOLD', required — Status of the ongoing project's workflow
  - `budget` number, required — Monetary value in EUR
  - `startDate` string, date, required
  - `endDate` string, date, required
  - `team` object[], required
    - `id` integer, required
    - `name` string, required
  - `manager` integer, required
  - `description` string, required

## Other responses

- `500` — An internal server error occurred.
- `503` — The service is temporarily unavailable. Maybe there is maintenance?

## Changes

- **2025-01-09** `29074eeb2bb5` — 2 info
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`
- **2025-01-08** `1a6865d8341f` — 1 warning, 1 info
  - deleted the `query` request parameter `teamMembersMode`
  - added the new optional `query` request parameter `teamMembersFiltering`
- **2025-01-08** `a89fbdd6d63d` — 1 info
  - added the new optional `query` request parameter `teamMembersMode`
- **2025-01-07** `659ddbe31a58` — 5 breaking, 7 warning, 8 info
  - removed the enum value `ACTIVE` from the `query` request parameter `status`
  - removed the enum value `COMPLETED` from the `query` request parameter `status`
  - removed the enum value `ON_HOLD` from the `query` request parameter `status`
  - removed the enum value `PLANNING` from the `query` request parameter `status`
  - …16 more

[Change history](https://skmtc.dev/ducin-public/apis/itcorpo-api/changes/projects/get.md)

---

[API](https://skmtc.dev/ducin-public/apis/itcorpo-api.md) · [All operations](https://skmtc.dev/ducin-public/apis/itcorpo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ducin-public/itcorpo-api/revisions/29074eeb2bb5/schema)
