---
title: "Busca avançada de projetos"
method: POST
path: "/api/management/projects/search"
tags: ["projects", "Projetos"]
---

# Busca avançada de projetos

`POST /api/management/projects/search`

Retorna uma lista de projetos, com alguns detalhes adicionais.

Consulte:

- [Busca avançada](https://docs.olie.ai/api-reference/general/advanced-search)
- [Paginação](https://docs.olie.ai/api-reference/general/pagination)

## Query parameters

- `withPercentage` boolean

## Request body

- object — Critérios da busca avançada.
  - `filters` object[] — Filtros aplicados à busca.
    - `field` string, required — Campo a filtrar.
    - `operator` 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'greater_than' | 'greater_than_or_equals' | 'less_than' | 'less_than_or_equals' | 'is_null' | 'is_not_null', required — Operador da comparação.
    - `value` unknown
    - `logical_operator` string — Como o filtro se junta ao anterior: `and` (padrão) ou `or`.
    - `arguments` unknown[] — Argumentos extras exigidos por alguns filtros.
      - unknown
  - `sorting` object[] — Ordenações aplicadas, na ordem de prioridade.
    - `field` string — Campo de ordenação.
    - `direction` 'asc' | 'desc' — Direção da ordenação.
  - `page` integer — Página desejada. Padrão 1.
  - `perPage` integer — Itens por página. Padrão 30, máximo 100.

## 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
- `422` — Filtro inválido

## Changes

- **2026-08-24** `3c590152d5b5` — 16 breaking, 17 warning, 24 info
  - request property `filters/items/operator` was restricted to a list of enum values
  - request property `sorting/items/direction` was restricted to a list of enum values
  - the request property `filters/items/field` became required
  - the request property `filters/items/operator` became required
  - …53 more
- **2026-08-19** `3d619d9db20d` — 2 info
  - api tag `Projetos` added
  - added the media type `application/json` for the response with the status `422`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/projects/search/post.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)