---
title: "Listar projetos de um grupo"
method: POST
path: "/api/management/project-groups/{project_group}/projects/index"
tags: ["project-groups", "projects", "index"]
---

# Listar projetos de um grupo

`POST /api/management/project-groups/{project_group}/projects/index`

Retorna, de forma paginada, os projetos associados ao grupo, sempre na ordem definida dentro do grupo — este endpoint não aceita ordenação personalizada. Cada projeto vem com as respostas dos formulários dinâmicos já preenchidas.

Os filtros usam o mesmo formato da [busca avançada](https://docs.olie.ai/api-reference/general/advanced-search) e a resposta segue o padrão de [paginação](https://docs.olie.ai/api-reference/general/pagination).

## Request body

- object
  - `filters` unknown[]
    - unknown
  - `page` integer
  - `perPage` integer
  - `trashed` boolean
  - `template` boolean
  - `withPercentage` boolean

## Response `200`

Sucesso

- object
  - `meta` object
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `per_page` integer
    - `to` integer
    - `total` integer
  - `response` boolean
  - `projects` object[]
    - `id` string
    - `code` string
    - `name` string
    - `description` string
    - `impact` integer
    - `frame_id` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `customer_id` string
    - `contact_id` integer
    - `merged_project` object — Projeto resultante de um merge, quando carregado.
    - `status` integer
    - `budget` integer
    - `is_template` boolean
    - `headquarter` object
      - `id` string
      - `name` string
    - `form_answers` unknown[]
      - unknown
    - `tasks` unknown[]
      - unknown
    - `customer` object
      - `id` string
      - `name` string
    - `contact` object
      - `id` integer
      - `name` string
      - `role` string
      - `email` string, email
      - `phone` string
      - `frame_id` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `customers` unknown[]
        - unknown
    - `funnels` unknown[]
      - unknown
    - `funnel_steps` unknown[]
      - unknown
    - `tags` unknown[]
      - unknown
    - `groups` object[]
      - `id` string
      - `name` string
    - `users` unknown[]
      - unknown
    - `frame` object
      - `id` string
      - `name` string
      - `subdomain` string
    - `executors` unknown[]
      - unknown

## Other responses

- `422` — Filtro inválido

## Changes

- **2026-09-22** `b43a04f35145` — 1 breaking, 16 warning
  - the `projects/items/contact/phone` response's property format changed from `utc-millisec` to no format for status `200`
  - removed the optional property `projects/items/contact/deleted_at` from the response with the `200` status
  - removed the optional property `projects/items/contact/description` from the response with the `200` status
  - removed the optional property `projects/items/costs` from the response with the `200` status
  - …13 more
- **2026-09-22** `711eea31b3dd` — 1 info
  - added the optional property `projects/items/merged_project` to the response with the `200` status
- **2026-09-18** `0abcbb399fb0` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `422`
- **2026-09-18** `626cc36dd5e6` — 1 info
  - added optional request body

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/project-groups/:project_group/projects/index/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.dev/olie-ai/apis/olie-api/revisions/b43a04f35145?raw)