---
title: "Retornar os contratos das unidades do cliente"
method: GET
path: "/contratos"
tags: ["Contratos"]
---

# Retornar os contratos das unidades do cliente

`GET /contratos`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/cliente`
- URL: `https://integracao.cvcrm.com.br/api/v1/cliente/contratos`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization, gerado pelo endpoint de autenticação do próprio Portal do Cliente: `POST /api/v1/cliente/autenticacao` (documento e senha do cliente) ou `POST /api/v1/cliente/autenticacao/sindico` (síndicos).
> ⚠️ O token de integração das APIs v2/v3 (`POST /api/v3/auth/token`) **não é válido** para o Portal do Cliente: ele não representa um cliente e as consultas retornarão vazias ou dados incorretos.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Listagem de Contratos

- object
  - `total` integer
  - `offset` integer
  - `limit` string, nullable
  - `contratos` object[]
    - `idcontrato` integer
    - `titulo` string
    - `tipo` string
    - `criado` string
    - `unidade` object
      - `idunidade` integer
      - `nome` string
      - `perfil` string, nullable
      - `previsao_entrega` string
      - `porcentagem_total_estagio_obra_unidade` integer
      - `data_entrega_chaves` string, nullable
      - `grupo_especial` string, nullable
      - `financeiro` boolean
      - `bloco` object
        - `idbloco` integer
        - `nome` string
      - `etapa` object
        - `idetapa` integer
        - `nome` string
      - `empreendimento` object
        - `idempreendimento` integer
        - `nome` string
        - `porcentagem_total_estagio_obra` string, nullable
        - `permitir_criar_atendimento` boolean
        - `permitir_criar_assistencia` boolean
        - `permitir_criar_agendamento` boolean
        - `data_entrega` string, nullable
        - `inicio_garantia` string, nullable
        - `foto` object
          - `nome` string
          - `tipo` string
          - `tamanho` integer
          - `url` string
      - `andar` string, nullable
      - `coluna` string, nullable
    - `arquivo` object
      - `nome` string, nullable
      - `tipo` string, nullable
      - `tamanho` string, nullable
      - `url` string

## Other responses

- `404`: Nenhum dado encontrado!
- `422`: Erro interno ao realizar ação!

---

[API](https://skmtc.dev/cvcrm/apis/portal-do-cliente.md) - [All operations](https://skmtc.dev/cvcrm/apis/portal-do-cliente/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/portal-do-cliente/revisions/7d95f9678127?raw)