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

# Retorna empreendimentos.

`GET /v1/cadastros/empreendimentos`

> 🔒 **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)

A api retornará o resumo de todos os empreendimentos cadastrados e ativos no ambiente do cliente. Para obter mais detalhes do empreendimento utilize a api cadastros/empreendimentos/{idempreendimento}

## Headers

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

## Response `200`

Retorno de todos os empreendimentos.

- object[] — Retorna no formato JSON informações dos empreendimentos.
  - `idempreendimento` integer — ID do empreendimento
  - `idempreendimento_int` string — Código interno do empreendimento
  - `referencia_externa` string — Referência de externa.
  - `nome` string — Nome do empreendimento
  - `regiao` string — Região do empreendimento
  - `cidade` string — Cidade do empreendimento
  - `estado` string — Estado do empreendimento
  - `bairro` string — Bairro do empreendimento
  - `endereco_emp` string — Endereço do empreendimento
  - `numero` string — Número do empreendimento
  - `logradouro` string — Logradouro do empreendimento
  - `cep` string — CEP do empreendimento
  - `endereco` string — Endereço completo do empreendimento
  - `idempresa` integer — ID da empresa
  - `sigla` string — Sigla do empreendimento
  - `link_disponibilidade` string — Link para disponibilidade do empreendimento
  - `logo` string — Logotipo do empreendimento
  - `foto_listagem` string — Imagem do empreendimento na listagem
  - `foto` string — Foto do empreendimento
  - `app_exibir` string — Exibe no APP
  - `app_cor_background` string — Cor do Backgound no APP
  - `data_entrega` string
  - `andamento` string — Andamento da obra em porcentagem
  - `unidades_disponiveis` integer — Quantidade de unidades disponíveis
  - `campos_adicionais` object[]
    - `nome_referencia` string — Nome de referência do campo adicional em empreendimentos.
    - `valor` string — Valor do campo adicional em empreendimentos.
  - `situacao_obra` object[]
    - `nome` string — Nome da situação da obra em empreendimentos
    - `idsituacao_obra` integer — Identificador da situação da obra em empreendimentos
  - `situacao_comercial` object[]
    - `nome` string — Nome da situação comercial em empreendimentos
    - `idsituacao_comercial` integer — Identificador da situação comercial em empreendimentos
  - `tipo_empreendimento` object[]
    - `nome` string — Nome do tipo empreendimento em empreendimentos
    - `idtipoemrpeendimento` integer — Identificador do tipo empreendimento em empreendimentos
  - `segmento` object[]
    - `nome` string — Nome do segmento em empreendimentos
    - `idsegmento` integer — Identificador do segmento em empreendimentos

## Other responses

- `422` — Erro ao tentar retornar empreendimentos.

---

[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/versions/42bf5add8bf3/schema)