---
title: "Obter um projeto"
method: GET
path: "/api/management/projects/{id}"
tags: ["projects", "Projetos"]
---

# Obter um projeto

`GET /api/management/projects/{id}`

Retorna os detalhes completos de um projeto pelo seu ID. O retorno inclui dados do próprio projeto, cliente e contato associados, funis em que o projeto está cadastrado (com todas as etapas, etiquetas, status e anexos), etapas atuais ocupadas, checklists avulsos, formulários respondidos do objeto projeto, grupos de projeto, usuários do projeto (criador e atribuídos), hierarquia (pai e filhos), executores envolvidos, etc.

## Query parameters

- `is_template` string

## Response `200`

Sucesso

- object — Detalhe completo de um projeto.
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `project` object, required — Projeto com todos os dados relacionados.
    - `id` string, uuid — ID (UUID) do projeto.
    - `code` string — Código do projeto.
    - `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.
    - `children_count` integer — Quantidade de projetos filhos diretos.
    - `customer` object, nullable — Cliente vinculado.
    - `contact` object, nullable — Contato vinculado.
    - `funnels` object[] — Funis em que o projeto está, com etapas, etiquetas, status e anexos.
    - `funnel_steps` object[] — Etapas que o projeto ocupa no momento.
    - `loose_checklists` object[] — Checklists avulsos do projeto.
    - `loose_forms` object[] — Formulários avulsos do projeto.
    - `users` object[] — Pessoas ligadas ao projeto, com o papel de cada uma.
    - `created_at` string, date-time — Data de criação.
    - `updated_at` string, date-time — Data da última alteração.

## Other responses

- `401` — Não autenticado
- `403` — Sem permissão
- `404` — Projeto não encontrado

## Changes

- **2026-08-24** `3c590152d5b5` — 48 breaking, 40 warning, 14 info
  - the response property `permission` became nullable for the status `403`
  - the response property `project/budget` became nullable for the status `200`
  - the response property `project/contact` became nullable for the status `200`
  - the response property `project/customer` became nullable for the status `200`
  - …98 more
- **2026-08-19** `3d619d9db20d` — 2 info
  - api tag `Projetos` added
  - api tag `{id}` removed
- **2026-05-15** `83dbf3595b50` — 19 breaking, 7 warning, 108 info
  - the response property `project/contact` became nullable for the status `200`
  - the response property `project/contact_id` became nullable for the status `200`
  - the response property `project/created_by` became nullable for the status `200`
  - the response property `project/customer` became nullable for the status `200`
  - …130 more
- **2026-05-14** `5518f45e115c` — 1 info
  - added the non-success response with the status `403`
- **2026-05-14** `13da3bab404c` — 1 info
  - added the new optional `query` request parameter `is_template`

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