---
title: "Recupera a lista de comissões"
method: GET
path: "/v1/financeiro/comissoes"
tags: ["Comissão"]
---

# Recupera a lista de comissões

`GET /v1/financeiro/comissoes`

> 🔒 **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 rota permite consultar e recuperar uma lista paginada de comissões registradas no sistema CVCRM.

A comissão representa um valor percentual ou fixo pago a um profissional (corretor e/ou equipe de vendas) com base no valor do contrato ou em outra base definida pela incorporadora, conforme suas regras configuradas no sistema.

Para garantir a eficiência da consulta e evitar retornos excessivamente amplos, a requisição deve ser filtrada obrigatoriamente por pelo menos um dos seguintes parâmetros (além dos headers de autenticação):

ID da comissão

ID da reserva

Documento do pagador

Data de cadastro (a_partir_de)

O endpoint utiliza paginação para controle do volume de registros retornados, permitindo melhor desempenho e previsibilidade nas integrações.

## Query parameters

- `idcomissao_cv` integer
- `idcomissao_int` string
- `idreserva_cv` integer
- `idreserva_int` string
- `documento_pagador` string
- `documento_quem` string
- `cancelados_excluidos` boolean
- `mostrar_identificadores` boolean
- `a_partir_de` string
- `ate` string
- `pagadoria` string

## Headers

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

## Response `200`

Operação realizada com sucesso.

- RetornoComissoes — Retorno das comissões cadastradas no CV
  - `total` integer — Total de resultados da query disponivel no banco de dados
  - `limit` integer — Limite de itens no conteudo da resposta
  - `offset` integer — Offset do inicio dos resultados
  - `totalConteudo` integer
  - `comissoes` object[]
    - `idcomissao_cv` integer
    - `idcomissao_int` string, nullable
    - `data_cad` string
    - `idsituacao` integer
    - `nome_situacao` string, nullable
    - `idreserva_cv` integer
    - `idreserva_int` string, nullable
    - `pagadoria` string, nullable
    - `numero_venda` string, nullable
    - `idempreendimento_cv` integer
    - `idempreendimento_int` string, nullable
    - `empreendimento` string
    - `idetapa_cv` integer
    - `idetapa_int` string, nullable
    - `etapa` string
    - `idbloco_cv` integer
    - `idbloco_int` string, nullable
    - `bloco` string
    - `idunidade_cv` integer
    - `idunidade_int` string, nullable
    - `unidade` string
    - `idpessoa_cv` integer
    - `idpessoa_int` string, nullable
    - `valor_comissao` number
    - `valor_comissao_tipo_comissao` number
    - `valor_comissao_tipo_premio` number
    - `idcorretor_cv` integer
    - `idcorretor_int` string, nullable
    - `idimobiliaria_cv` integer
    - `idimobiliaria_int` string, nullable
    - `corretor_nome` string, nullable
    - `imobiliaria_nome` string, nullable
    - `data_cancelamento` string, nullable — Retornado apenas quando idcomissao_cv é informado
    - `data_finalizacao` string, nullable — Retornado apenas quando idcomissao_cv é informado
    - `pagador` object
      - `idpessoa_cv` integer
      - `idpessoa_int` string, nullable
      - `nome` string
      - `documento` string
      - `tipo_documento` string
      - `email` string
      - `data_nascimento` string, nullable
      - `logradouro` string, nullable
      - `endereco` string, nullable
      - `numero` string, nullable
      - `bairro` string, nullable
      - `cep` string, nullable
      - `estado` string, nullable
      - `cidade` string, nullable
      - `telefone` string, nullable
      - `estado_civil` integer, nullable
    - `beneficiarios` object[]
      - `nome` string
      - `documento` string
      - `documento_faturamento` string, nullable
      - `email` string
      - `data_nascimento` string, nullable
      - `comissao_tipo` string
      - `valor` number
      - `para` string
      - `idbeneficiario_cv` integer
      - `idbeneficiario_int` string, nullable
      - `programacao` object[]
        - `idpagamento` integer
        - `idsituacao` integer
        - `situacao` string, nullable
        - `forma_pagamento` string, nullable
        - `valor` number
        - `vencimento` string
        - `data_medicao` string, nullable
        - `observacoes` string, nullable
        - `codigo_pagadoria` string, nullable
        - `codigo_pagadoria_int` string, nullable
        - `codigo_linkpay` integer, nullable
        - `cancelado` boolean
        - `excluido` boolean
    - `documentos_pagamento` object[]
      - `idarquivo_cv` integer
      - `idpagamento_cv` integer
      - `data_cad` string
      - `tipo` string
      - `nome` string
      - `arquivo_tipo` string
      - `arquivo_base64` string
    - `lotes_pagamento` object[]
      - `idpagamento` integer
      - `idpagamento_legado` integer
      - `idcomissao` integer
      - `data_cad` string
      - `ativo` string
      - `valor` number
      - `data_pagamento` string
      - `nota_fiscal` string
      - `idreserva_comissao` integer
      - `data_medicao` string
      - `obs_medicao` string
      - `situacao` string
      - `codigointerno` string
      - `forma_pagamento` string, nullable
      - `idprogramacaoreserva` integer
      - `cancelamento` string
      - `idsituacao` integer
      - `bloqueado` string
      - `motivo_bloqueio` string
      - `idlote` integer
    - `mensagens` object[]
      - `idmensagem_cv` integer
      - `nome` string
      - `mensagem` string
      - `data` string
      - `arquivos` object[]
        - `idarquivo_cv` integer
        - `data_cad` string
        - `nome` string
        - `arquivo_tipo` string
        - `arquivo_base64` string
    - `pagamentos` object[]
      - `idpagamento` integer
      - `data_pagamento` string
      - `nota_fiscal` string
      - `idsituacao` integer
      - `situacao` string
      - `forma_pagamento` string, nullable
      - `valor` number
      - `data_medicao` string
      - `obs_medicao` string
      - `enviar_pagadoria` string

## Other responses

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