---
title: "Retorna as cessões de direitos"
method: GET
path: "/v1/comercial/reservas/cessao"
tags: ["Cessão"]
---

# Retorna as cessões de direitos

`GET /v1/comercial/reservas/cessao`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v1/comercial/reservas/cessao`
- Auth: none declared. Required headers: `email`, `token`

> 🔒 **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 as cessões de direitos cadastradas no sistema.

## Query parameters

- `limit` integer
- `offset` integer
- `idcessao` integer
- `idreserva` integer
- `idunidade` integer
- `documento_cliente_cedente` string, string
- `documento_cliente_cessionario` string, string

## Headers

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

## Response `200`

Cessões retornadas com sucesso.

- GetCessao: Retorno das cessões de direitos
  - `total` integer: Total de cessões da query disponível no banco de dados
  - `limit` integer: Limite de itens no conteúdo da resposta de cessões
  - `offset` integer: Offset do início das cessões
  - `totalConteudo` integer: Total de cessões da página
  - `cessoes` object[]: Cessões de direitos
    - `idcessao` integer: Identificador da cessão
    - `data_cessao` string, string: Data que a cessão foi realizada
    - `idmotivo` integer: Identificador motivo da cessão
    - `motivo` string, string: Motivo da cessão
    - `idempreendimento` integer: Identificador do empreendimento
    - `empreendimento` string, string: Nome do empreendimento
    - `idunidade` integer: Identificador da unidade
    - `unidade` string, string: Nome da unidade
    - `idreserva` integer: Identificador da reserva
    - `cliente_cedente` object
      - `idpessoa` integer: Identificador do cliente cedente
      - `idpessoa_int` string, string: Código interno do cliente cedente
      - `nome` string, string: Nome do cliente cedente
      - `documento` string, string: CPF/CNPJ do cliente cedente
    - `associado_cedente` object
      - `idpessoa` integer: Identificador do associado cedente
      - `idpessoa_int` string, string: Código interno do associado cedente
      - `nome` string, string: Nome do associado cedente
      - `documento` string, string: CPF/CNPJ do associado cedente
    - `cliente_cessionario` object
      - `idpessoa` integer: Identificador do cliente cessionário
      - `idpessoa_int` string, string: Código interno do cliente cessionário
      - `nome` string, string: Nome do cliente cessionário
      - `documento` string, string: CPF/CNPJ do cliente cessionário
    - `associado_cessionario` object
      - `idpessoa` integer: Identificador do associado cessionário
      - `idpessoa_int` string, string: Código interno do associado cessionário
      - `nome` string, string: Nome do associado cessionário
      - `documento` string, string: CPF/CNPJ do associado cessionário

## Other responses

- `404`: URL não encontrada na requisição de cessão.
- `422`: Ocorreu um erro inesperado na requisição de cessão, por favor tente mais tarde.

---

[API](https://skmtc.dev/cvcrm/apis/clientes.md) - [All operations](https://skmtc.dev/cvcrm/apis/clientes/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/clientes/revisions/42bf5add8bf3?raw)
