---
title: "Retorna as reservas de acordo com os filtros"
method: GET
path: "/v1/comercial/reservas"
tags: ["Reserva"]
---

# Retorna as reservas de acordo com os filtros

`GET /v1/comercial/reservas`

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

Esta API serve como um informativo ao sistema legado acerca das reservas que podem ser integradas como vendidas, por esse motivo não há solicitação de preenchimento de dados para a sua execução. Neste caso, como a requisição é do tipo 'GET', somente são necessários passar os parâmetros de autenticação por meio do HEADER, ou seja, a requisição não terá BODY.


**Obs: Ela também fará consultas no Construtor de Vendas por reservas em situação com flag 'pode faturar' ou 'vendida', tendo o controle pelos parâmetros da query especificados exclusivamente (i.e. não pode especificar os dois num mesmo request).**


**Obs2: Reservas que ainda não foram integradas (possuem a coluna codigointerno populada) não são listadas, este padrão pode ser configurado com o parâmetro retornar_integradas.**

## Query parameters

- `documento` string, string
- `situacao` string, string
- `faturar` boolean
- `apenas_ativas` boolean
- `retornar_integradas` boolean
- `idempreendimento` integer
- `condicao_completa` boolean
- `series_por_valor_liquido` boolean
- `pagamento_comissao` boolean
- `pagina` integer
- `registros_por_pagina` integer
- `idgrupo` integer
- `a_partir_de` string, string
- `campos_adicionais_reserva_contrato` boolean

## Headers

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

## Response `200`

Reservas retornadas com sucesso.

- RetornoReservas — Lista as reservas no CVCRM. As chaves do objeto são os IDs das reservas (número inteiro).

## Other responses

- `204` — Requisição Incorreta! Reservas dado foi encontrado.
- `400` — Erro de solicitação de reservas, revise os parâmetros!
- `401` — E-mail e/ou token incorreto(s) na requisição de reservas.
- `403` — Sem permissão no perfil de acesso ou módulo inativo para retornar reservas.
- `404` — URL não encontrada na requisição de reservas.
- `422` — Erro inesperado na requisição de reservas, 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/versions/42bf5add8bf3/schema)