---
title: "Retorna os documentos cadastrados na reserva"
method: GET
path: "/v1/comercial/reservas/{idReserva}/documentos"
tags: ["Documentos"]
---

# Retorna os documentos cadastrados na reserva

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

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

Retorna os documentos cadastrados na reserva informada.

## Path parameters

- `idReserva` integer, required

## Headers

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

## Response `200`

Documentos retornados com sucesso.

- RetornarDocumentoSucesso — Documentos das reservs
  - `total_de_registros` integer — Quantidade de documentos encontrados.
  - `dados` object[] — Informações das reservas e documentos
    - `idreserva_cv` integer — Identificador da reserva
    - `idreserva_int` string, string — Identificador interno da reserva no sistema externo
    - `idempreendimento_cv` integer — Identificador do empreendimento
    - `idempreendimento_int` string, string — Identificador interno do empreendimento no sistema externo
    - `idunidade_cv` integer — Identificador da unidade
    - `idunidade_int` string, string — Identificador interno da unidade no sistema externo
    - `idpessoa_cv` integer — Identificador da pessoa
    - `idpessoa_int` string, string — Identificador interno da pessoa no sistema externo
    - `documentos` object[] — Documentos
      - `tipo_pessoa` object[]
        - `idreservasdocumentos` integer — Identificador do documento
        - `nome` string, string — Nome do documento
        - `situacao` string, string — Situação do documento
        - `motivo_reprovacao` string, string — Motivo da reprovação
        - `descricao_motivo_reprovacao` string, string — Descrição do motivo da reprovação
        - `idtipo` integer — Identificador do tipo do documento
        - `tipo` string, string — Tipo do documento no CVCRM
        - `idtipo_associacao` integer — Identificador do tipo de associação do documento
        - `link` string, string — Link para download do documento

## Other responses

- `204` — Não há documentos nesta reserva.
- `400` — Erro de integração na requisição de documentos da reserva!
- `401` — E-mail e/ou token incorreto(s) na requisição de documentos da reserva.
- `403` — Sem permissão no perfil de acesso ou módulo inativo retornar documentos da reserva.
- `404` — URL não encontrada na requisição de documentos da reserva.
- `422` — Ocorreu um erro inesperado na requisição de documentos da reserva, por favor tente mais tarde.

---

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