---
title: "Retornar contratos da reserva"
method: GET
path: "/v1/comercial/reservas/{idReserva}/contratos"
tags: ["Contratos"]
---

# Retornar contratos da reserva

`GET /v1/comercial/reservas/{idReserva}/contratos`

> 🔒 **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 interface viabiliza a consulta dos contrato de uma reserva do sistema CV. A consulta é realizada através do id da reserva enviado na URL. A requisição retorna os dados do(s) contrato(s).

## Path parameters

- `idReserva` integer, required

## Headers

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

## Response `200`

Contratos da reserva retornados com sucesso.

- GetContratos — Retorno dos contratos das reservas
  - `total_de_registros` integer — Total de contratos da query disponível no banco de dados
  - `dados` object[]
    - `idreserva_cv` integer — Identificador da reserva no Construtor de Vendas
    - `idreserva_int` integer — Identificador interno da reserva no sistema externo
    - `idempreendimento_cv` integer — Identificador do empreendimento no Construtor de Vendas
    - `idempreendimento_int` string, string, nullable — Identificador interno do empreendimento no sistema externo
    - `idunidade_cv` integer — Identificador da unidade no Construtor de Vendas
    - `idunidade_int` string, string — Identificador interno da unidade no sistema externo
    - `idpessoa_cv` integer — Identificador do cliente no Construtor de Vendas
    - `idpessoa_int` string, string, nullable — Identificador interno do cliente no sistema externo
    - `campos_adicionais` object[] — Campos adicionais da reserva
      - `id` integer — Id do campo na reserva
      - `nome` string — Nome do campo adicional
      - `valor` string — Valor do campo adicional
    - `contratos` object[] — Contratos das reservas
      - `idreservacontrato` integer — Identificado do contrato na reserva
      - `contrato` string, string — Nome do contrato
      - `tipo` string, string — Tipo do contrato
      - `assinado` string, string, nullable — Informa data em que o contrato foi assinado
      - `validado` string, string, nullable — Informa data em que o contrato foi validado
      - `link` string, string — Link para baixar o contrato

## Other responses

- `204` — Requisição Incorreta! Nenhum contrato foi encontrado.
- `400` — Erro de solicitação dos contratos da reserva, revise os parâmetros!
- `401` — E-mail e/ou token incorreto(s) na requisição de contratos da reserva.
- `403` — Sem permissão no perfil de acesso ou módulo inativo para contratos da reserva.
- `404` — URL não encontrada na requisição de contratos da reserva.
- `422` — Erro inesperado na requisição de contratos da reserva, por favor entre em contato com o suporte técnico.

---

[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)