---
title: "Retorna empreendimento."
method: GET
path: "/v1/cadastros/empreendimentos/{idEmpreendimento}"
tags: ["Empreendimento"]
---

# Retorna empreendimento.

`GET /v1/cadastros/empreendimentos/{idEmpreendimento}`

> 🔒 **Autenticação necessária**
>
> Esta API utiliza autenticação via **e-mail e token** nos headers da requisição.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token)

Essa interface trará todos os dados de um determinado empreendimento, serão disponibilizadas as informações de todos os blocos, etapas e unidades do empreendimento selecionado.

## Path parameters

- `idEmpreendimento` integer, required

## Query parameters

- `limite_dados_unidade` integer
- `pagina_unidade` integer

## Headers

- `email` string, required
- `token` string, required

## Response `200`

Retorno do empreendimento

- RetornoEmpreendimento — Retorna no formato JSON informações do empreendimento.
  - `idempreendimento` string
  - `idempreendimento_int` string
  - `referencia_externa` string — Referência de externa.
  - `nome` string
  - `matricula` string
  - `regiao` string
  - `cidade` string
  - `estado` string
  - `bairro` string
  - `endereco_emp` string
  - `numero` string
  - `logradouro` string
  - `cep` string
  - `endereco` string
  - `periodo_venda_inicio` string
  - `area_construida` string
  - `area_privativa` string
  - `idempresa` integer
  - `idempresa_int` string
  - `nome_empresa` string
  - `razao_social_empesa` string
  - `cnpj_empesa` string
  - `endereco_empresa` string
  - `integrado` string
  - `logo` string
  - `latitude` string
  - `longitude` string
  - `titulo` string
  - `descricao` string
  - `data_entrega` string
  - `campos_adicionais` object[]
    - `nome_referencia` string — Nome de referência do campo adicional de empreendimento.
    - `valor` string — Valor do campo adicional de empreendimento.
  - `situacao_obra` object[]
    - `nome` string — Nome da situação da obra
    - `idsituacao_obra` integer — Identificador da situação da obra
  - `situacao_comercial` object[]
    - `nome` string — Nome da situação comercial
    - `idsituacao_comercial` integer — Identificador da situação comercial
  - `tipo_empreendimento` object[]
    - `nome` string — Nome do tipo empreendimento
    - `idtipoemrpeendimento` integer — Identificador do tipo empreendimento
  - `segmento` object[]
    - `nome` string — Nome do segmento
    - `idsegmento` integer — Identificador do segmento
  - `etapas` Etapas — Retorna no formato JSON informações da etapa de um empreendimento.
    - `idetapa` integer
    - `idetapa_int` string
    - `idempreendimento` integer
    - `nome` string
    - `data_cad` string
    - `blocos` object[] — Retorna no formato JSON informações dos blocos de um empreendimento.
      - `idbloco` integer
      - `idbloco_int` string
      - `idetapa` integer
      - `nome` string
      - `data_cad` string
      - `paginacao` object[] — Retorna no formato JSON informações das paginações das unidades.
        - `total` integer
        - `limite_dados_unidade` integer
        - `pagina_unidade` integer
        - `paginas_total` integer
      - `unidades` Unidades
        - `idunidade` integer
        - `nome` string
  - `plantas` Plantas — Retorna no formato JSON informações da planta de um empreendimento.
    - `idplanta` integer
    - `nome` string
    - `especificacoes` string
    - `data_cad` string
    - `img_planta_servidor` string
    - `imagens` unknown[]
      - unknown
  - `tabela` object[] — Array com dados das tabelas do empreendimento.
    - `idtabela` string
    - `nome` string
    - `forma` string
    - `tipo` string
    - `data_vigencia_de` string
    - `data_vigencia_ate` string
    - `aprovado` string
    - `valor_metro` string
  - `materiais_campanha` object[] — Array com dados dos materiais de campanha do empreendimento.
    - `idarquivo` string
    - `nome` string
    - `servidor` string
    - `tipo` string
    - `tamanho` string
    - `titulo` string
    - `descricao` string
    - `arquivo` string
  - `plantas_mapeadas` object[]
    - `idplanta_mapeada` integer — Id da planta
    - `nome` string — Nome da planta
    - `link` string — Link para visualizar a planta
    - `pontos` object[]
      - `idponto` integer — Id do ponto
      - `idunidade` integer — Id do unidade
      - `nome` string — Nome do ponto
      - `cor` string — Cor do ponto
      - `vetor` object
        - `x` string — Posição X do ponto
        - `y` string — Posição Y do ponto
        - `r` string — R do ponto
        - `s` string — S do ponto
        - `m` string — M do ponto
      - `nome_unidade` string — Nome da Unidade
      - `data_cad` string — Data de cadastro
      - `situacao` integer — Situação
      - `area_privativa` string — Área privativa
      - `situacao_mapa_disponibilidade` integer — Situação no mapa disponibilidade
      - `legenda` string — Legenda
      - `sublegenda` string — Sub-legenda

## Other responses

- `422` — Erro ao retornar empreendimento.

---

[API](https://skmtc.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/revisions/42bf5add8bf3/schema)