---
title: "Obter análises dos descendentes"
method: GET
path: "/api/management/projects/{project}/hierarchy/analytics"
tags: ["projects", "Hierarquia"]
---

# Obter análises dos descendentes

`GET /api/management/projects/{project}/hierarchy/analytics`

Consolida em um único retorno os números de todos os projetos abaixo do projeto informado — financeiro, tarefas, funis e pessoas envolvidas — para uma visão macro da estrutura.

Projetos sem nenhum descendente respondem com erro, já que não há o que consolidar.

## Response `200`

Sucesso

- object — Análises agregadas da hierarquia.
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `data` object, required — Números consolidados dos descendentes.
    - `budget` object — Números financeiros.
      - `total_budget` number — Soma dos orçamentos.
      - `average_budget` number — Média dos orçamentos maiores que zero.
      - `budget_distribution` object — Quantidade de projetos por valor de orçamento.
      - `projects_with_budget` integer — Projetos com orçamento.
      - `projects_without_budget` integer — Projetos sem orçamento.
      - `budget_range` object — Faixa de orçamento.
        - `min` number — Menor orçamento.
        - `max` number — Maior orçamento.
    - `funnels` object — Números de funis.
      - `total_funnels` integer — Funis distintos usados pelos descendentes.
      - `average_funnels_per_project` number — Média de funis por projeto.
      - `funnels_per_project` object — Quantidade de funis por projeto.
      - `projects_per_step` object — Quantidade de projetos por etapa.
      - `projects_with_funnels` integer — Projetos em algum funil.
      - `projects_without_funnels` integer — Projetos fora de qualquer funil.
    - `users` object — Números de pessoas.
      - `total_users` integer — Pessoas distintas envolvidas.
      - `total_user_assignments` integer — Total de vínculos de pessoas com projetos.
      - `average_users_per_project` number — Média de pessoas por projeto.
      - `users_by_role` object — Quantidade de vínculos por papel.
      - `users_per_project` object — Quantidade de pessoas por projeto.
      - `projects_with_users` integer — Projetos com alguém vinculado.
      - `projects_without_users` integer — Projetos sem ninguém vinculado.
    - `status` object — Distribuição por situação.
      - `by_status` object — Quantidade de projetos por situação.
      - `total_projects` integer — Total de projetos considerados.
      - `status_distribution_percentage` object — Percentual de projetos por situação.
    - `impact` object — Distribuição por impacto.
      - `by_impact` object — Quantidade de projetos por grau de impacto.
      - `average_impact` number — Impacto médio.
      - `impact_range` object — Faixa de impacto.
        - `min` number — Menor impacto.
        - `max` number — Maior impacto.
      - `high_impact_projects` integer — Projetos com impacto 8 ou mais.
      - `medium_impact_projects` integer — Projetos com impacto de 4 a 7.
      - `low_impact_projects` integer — Projetos com impacto 3 ou menos.
    - `hierarchy` object — Formato da estrutura.
      - `total_levels` integer — Níveis ocupados pela estrutura.
      - `level_distribution` object — Quantidade de projetos por nível.
      - `leaf_projects` integer — Projetos sem filhos.
      - `branch_projects` integer — Projetos com filhos.
      - `branch_to_leaf_ratio` number — Relação entre projetos com e sem filhos.
      - `average_children_per_branch` number — Média de filhos por projeto que tem filhos.
    - `timeline` object — Evolução no tempo.
      - `recent_projects` object — Projetos criados por janela de tempo.
        - `last_30_days` integer — Criados nos últimos 30 dias.
        - `last_90_days` integer — Criados nos últimos 90 dias.
        - `last_365_days` integer — Criados nos últimos 365 dias.
      - `recently_updated` integer — Projetos alterados recentemente.
      - `monthly_creation_trend` object — Projetos criados por mês, no formato AAAA-MM.
      - `oldest_project_age_days` integer — Idade do projeto mais antigo, em dias.
      - `newest_project_age_days` integer — Idade do projeto mais novo, em dias.

## Other responses

- `422` — Projeto sem descendentes

## Changes

- **2026-08-24** `3c590152d5b5` — 8 breaking, 19 warning, 5 info
  - the `data/budget/average_budget` response's property type changed from `integer` to `number` for status `200`
  - the `data/budget/budget_range/max` response's property type changed from `integer` to `number` for status `200`
  - the `data/budget/budget_range/min` response's property type changed from `integer` to `number` for status `200`
  - the `data/budget/total_budget` response's property type changed from `integer` to `number` for status `200`
  - …28 more
- **2026-08-19** `3d619d9db20d` — 3 info
  - api tag `Hierarquia` added
  - api tag `hierarchy` removed
  - api tag `{id}` removed
- **2026-08-19** `5501d8ecc8a0` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `422`

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