---
title: "Listar projetos"
method: GET
path: "/api/management/projects"
tags: ["projects", "Projetos"]
---

# Listar projetos

`GET /api/management/projects`

Esta rota é normalmente utilizada para campos de autocomplete, e buscas mais simples, pois é uma rota que entrega menos informações que uma busca avançada. Se você estiver buscando encontrar projetos baseado em um conjunto de filtros avançados e específicos, considere usar a busca avançada.

Possui paginação e aceita alguns filtros via query params, consulte:

- [Filtro básico](https://docs.olie.ai/api-reference/general/basic-filters)
- [Paginação](https://docs.olie.ai/api-reference/general/pagination)

## Query parameters

- `page` integer
- `perPage` integer
- `search` string
- `id` string
- `trashed` boolean
- `template` boolean
- `sort` string
- `direction` 'asc' | 'desc'

## Response `200`

Sucesso

- object — Lista paginada de projetos.
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `meta` object — Dados da paginação.
    - `current_page` integer — Página retornada.
    - `from` integer, nullable — Posição do primeiro item da página no total.
    - `to` integer, nullable — Posição do último item da página no total.
    - `last_page` integer — Número da última página.
    - `per_page` integer — Itens por página.
    - `total` integer — Total de itens encontrados.
  - `projects` object[], required — Projetos encontrados.
    - `id` string, uuid — ID (UUID) do projeto.
    - `frame_id` string, uuid — ID (UUID) da conta dona do projeto.
    - `code` string — Código do projeto, formado pelo prefixo e por um número sequencial.
    - `name` string — Nome do projeto.
    - `description` string, nullable — Descrição do projeto.
    - `status` integer — Situação: 1 em andamento, 2 concluído, 3 arquivado, 4 parado.
    - `impact` integer, nullable — Grau de impacto, de 1 a 10.
    - `budget` number, nullable — Orçamento do projeto.
    - `is_template` boolean — Indica se o projeto é um modelo.
    - `parent_id` string, uuid, nullable — ID do projeto pai, quando este é um subprojeto.
    - `customer_id` string, uuid, nullable — ID do cliente vinculado.
    - `contact_id` string, uuid, nullable — ID do contato vinculado.
    - `created_by` string, uuid, nullable — ID do usuário que criou o projeto.
    - `created_at` string, date-time — Data de criação.
    - `updated_at` string, date-time — Data da última alteração.
    - `deleted_at` string, date-time, nullable — Data em que foi enviado para a lixeira.

## Other responses

- `401` — Não autorizado

## Changes

- **2026-08-24** `3c590152d5b5` — 11 breaking, 17 warning, 5 info
  - the response property `meta/from` became nullable for the status `200`
  - the response property `meta/to` became nullable for the status `200`
  - the response property `projects/items/budget` became nullable for the status `200`
  - the response property `projects/items/created_by` became nullable for the status `200`
  - …29 more
- **2026-08-19** `3d619d9db20d` — 3 info
  - api tag `Projetos` added
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `401`
- **2026-08-19** `142cd6598699` — 1 warning, 1 info
  - deleted the `query` request parameter `filter`
  - added the new optional `query` request parameter `id`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/projects/get.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)