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

# 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
  - `response` boolean, required — Indica que a requisição foi processada com sucesso.
  - `project` object, required
    - `id` string, uuid, required — Identificador do projeto.
    - `parent_id` string, uuid — ID do projeto pai na hierarquia.
    - `old_id` string — Identificador legado, preservado em migrações.
    - `code` string, required — Código curto do projeto (prefixo do funil + número sequencial).
    - `name` string, required
    - `description` string
    - `impact` integer, required — Impacto declarado do projeto.
    - `frame_id` string, uuid, required — ID da empresa (frame) dona do projeto.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `customer_id` string, uuid
    - `contact_id` string, uuid
    - `share_token` string — Token público para compartilhamento externo.
    - `share_settings` object
    - `merged_id` string, uuid — ID do projeto em que este foi mesclado.
    - `status` 1 | 2 | 3 | 4, required — 1=Em andamento, 2=Concluído, 3=Arquivado, 4=Pausado.
    - `budget` number, required — Orçamento do projeto.
    - `is_template` boolean, required
    - `created_by` string, uuid — ID do usuário que criou o projeto.
    - `deleted_at` string, date-time
    - `children_count` integer, required — Quantidade de projetos filhos diretos.
    - `form` object — Formulário dinâmico hidratado, quando aplicável.
    - `executors` object[], required — Usuários executores envolvidos nas tarefas e seus custos.
      - `id` string, uuid, required
      - `user` string, required — Nome do executor.
      - `hourly_rate` number, required — Valor-hora declarado no vínculo do usuário com o frame.
      - `elapsed` integer, required — Tempo realizado, em segundos.
      - `elapsed_amount` number, required — Custo realizado.
      - `expected` integer, required — Tempo previsto, em segundos.
      - `expected_amount` number, required — Custo previsto.
    - `customer` object — Cliente vinculado, com os campos do recurso Customer.
    - `contact` object — Contato vinculado, com os campos do recurso Contact.
    - `funnels` object[], required — Funis em que o projeto está cadastrado, incluindo todas as etapas, etiquetas, status e anexos do funil.
      - `id` integer, required
      - `name` string, required
      - `prefix` string, required — Prefixo usado para gerar o código dos projetos.
      - `order` integer
      - `condition` 'active' | 'inactive', required
      - `allow_multi_step` boolean
      - `show_cost_info` boolean
      - `business_area_id` integer
      - `form_id` integer
      - `frame_id` string, uuid, required
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `deleted_at` string, date-time
      - `funnel_config_template_id` integer
      - `allow_execution` boolean
      - `project_term` integer
      - `pivot` object, required
        - `project_id` string, uuid, required
        - `project_funnel_id` integer, required
        - `id` integer, required
        - `statuses_at` string, date-time
        - `statuses_by` string, uuid
        - `funnel_status_id` integer
        - `forecast_date` string, date-time
        - `realized_forecast_date` string, date-time
        - `created_at` string, date-time, required
        - `forecast_date_update_count` integer, required
      - `steps` object[], required
        - `id` integer, required
        - `name` string, required
        - `project_funnel_id` integer, required
        - `sensation_amount` integer
        - `step_forward_id` integer
        - `step_backward_id` integer
        - `order` integer, required
        - `help_text` string
        - `form_id` integer
        - `sort_config` object
        - `allow_execution` boolean
        - `show_customer_form` boolean
        - `show_contact_form` boolean
        - `hide_customer_form_when_linked` boolean
        - `hide_contact_form_when_linked` boolean
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `deleted_at` string, date-time
        - `checklists` object[]
        - `attachments` object[]
        - `form` object
      - `form` object
      - `tags` object[], required
        - `id` integer, required
        - `name` string, required
        - `color` string, required — Cor em hex (ex.: #ff8d92).
        - `project_funnel_id` integer, required
        - `deleted_at` string, date-time
      - `funnel_status` object[], required
        - `id` integer, required
        - `name` string, required
        - `color` string, required
        - `project_funnel_id` integer, required
        - `is_conclusive` boolean, required
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `deleted_at` string, date-time
      - `attachments` object[], required
    - `project_checklists` object[], required — Itens de checklist avulsos vinculados ao projeto.
      - `id` string, uuid, required
      - `name` string, required
      - `completed_at` string, date-time
      - `author_id` string, uuid — Usuário responsável pelo item.
      - `checked_by_id` string, uuid — Usuário que marcou o item como concluído.
      - `project_id` string, uuid, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `order` integer, required
    - `funnel_steps` object[], required — Etapas atualmente ocupadas pelo projeto, com bloqueios herdados da etapa.
      - `id` integer, required
      - `name` string, required
      - `project_funnel_id` integer, required
      - `sensation_amount` integer
      - `step_forward_id` integer
      - `step_backward_id` integer
      - `order` integer
      - `help_text` string
      - `form_id` integer
      - `sort_config` object
      - `allow_execution` boolean
      - `show_customer_form` boolean
      - `show_contact_form` boolean
      - `hide_customer_form_when_linked` boolean
      - `hide_contact_form_when_linked` boolean
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `deleted_at` string, date-time
      - `pivot` object, required
        - `project_id` string, uuid, required
        - `funnel_step_id` integer, required
        - `id` integer, required
        - `order` integer, required
        - `created_at` string, date-time, required
      - `funnel_step_blockings` object[], required
    - `step_form` object[], required — Formulários respondidos por etapa do funil.
    - `checklists` object[], required — Checklists das etapas (não confundir com project_checklists).
    - `tags` object[], required — Etiquetas atribuídas ao projeto (sempre originárias de um funil).
      - `id` integer, required
      - `name` string, required
      - `color` string, required
      - `project_funnel_id` integer, required
      - `deleted_at` string, date-time
      - `pivot` object, required
        - `project_id` string, uuid, required
        - `funnel_tag_id` integer, required
        - `id` integer, required
    - `merged_project` object — Projeto resultante de uma fusão (apenas referência mínima).
      - `id` string, uuid
      - `code` string
      - `name` string
    - `loose_forms` object[], required — Formulários avulsos respondidos no projeto.
    - `forum` object — Forum dedicado do projeto, quando habilitado.
    - `groups` object[], required — Grupos aos quais o projeto pertence.
    - `users` object[], required — Membros do projeto. O pivot informa a função (creator, leader, member etc.).
      - `id` string, uuid, required
      - `name` string, required
      - `avatar_url` string, uri
      - `pivot` object, required
        - `project_id` string, uuid, required
        - `user_id` string, uuid, required
        - `role` string, required — Função do usuário no projeto (creator, leader, member, ...).
        - `created_at` string, date-time
        - `updated_at` string, date-time
    - `children` object[], required — Projetos filhos diretos na hierarquia (referências resumidas).
    - `parent` object — Projeto pai na hierarquia, quando houver.
    - `frame` object, required — Empresa (tenant) dona do projeto.
      - `id` string, uuid, required
      - `old_id` string
      - `name` string, required
      - `type` string, required — Tipo de frame ("1"=Personal, "2"=Company, etc.).
      - `read_only_until` string, date-time — Frame em modo somente-leitura até esta data, quando preenchido.
      - `status` integer, required — 1=ativo, 0=inativo.
      - `subdomain` string, required
      - `frame_billing_data_id` string, uuid
      - `model_forms` object
      - `logo_img` string — URL/caminho do logo.
      - `cockpit_access` 0 | 1 — Indica se o frame possui acesso ao cockpit.

## Other responses

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

---

[API](https://skmtc.net/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.net/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olie-ai/olie-api/versions/4859f7ec8b64/schema)