---
title: "Retorna os dados dos corretores"
method: GET
path: "/corretores"
tags: ["Corretores"]
---

# Retorna os dados dos corretores

`GET /corretores`

> 🔒 **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 retorna os dados dos Corretores a partir dos filtros solicitados, caso deseje saber o que cada campo representa basta ir no schema.

## Query parameters

- `pagina` integer
- `registros_por_pagina` integer
- `a_partir_referencia` integer
- `a_partir_data_referencia` string
- `ate_data_referencia` string

## Headers

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

## Response `200`

Corretor

- object — Retorna os dados dos corretores.
  - `pagina` integer — Página atual do retorno dos registros
  - `registros` integer — Quantidade de registro da página, máximo 500 registros
  - `total_de_registros` integer — Total de registros encontrados
  - `total_de_paginas` integer — Total de páginas encontradas
  - `dados` Corretor[]
    - `referencia` string — Código identificador da corretor
    - `referencia_data` string — Data de referência
    - `ativo` string — Informa se está ativo ou não
    - `ativo_login` string — Indica se está ativo no login
    - `idcorretor` integer — Identificador da corretor
    - `idimobiliaria` integer — Identificador da imobiliaria
    - `data_cad` string — Data de Cadastro do Corretor
    - `documento` string — Número do documento (CPF/CNPJ) do corretor
    - `nome` string — Nome do corretor
    - `apelido` string — Apelido do corretor
    - `avatar` string — URL do avatar do corretor
    - `avatar_nome` string — Nome do arquivo do avatar do corretor
    - `avatar_servidor` string — Nome do arquivo do avatar do corretor no servidor
    - `avatar_tipo` string — Tipo do arquivo do avatar do corretor
    - `avatar_tamanho` integer — Tamanho do arquivo do avatar do corretor
    - `sexo` string — Sexo do Corretor
    - `estado_civil` string — Estado Civil do Corretor
    - `data_nasc` string — Data de nascimento do Corretor
    - `telefone` string — Telefone do Corretor
    - `celular` string — Celular do Corretor
    - `rg` string — Numero do rg do corretor
    - `rg_orgao_expedidor` string — Orgão Expedidor
    - `rg_data_emissao` string — Data de Emissão do RG
    - `data_readmissao` string — Data de Readmissão do Corretor
    - `numero_pis` string — Numero do Pis
    - `naturalidade` string — Naturalidade do Corretor
    - `pais` string — País do Corretor
    - `possui_filhos` integer — Quantidade de filhos
    - `dependentes` integer
    - `tamanho_camisa` string
    - `razao_social` string
    - `contrato_social_nire` string
    - `inscricao_estadual` string
    - `cep` string
    - `logradouro` string
    - `endereco` string
    - `bairro` string
    - `numero` string
    - `complemento` string
    - `estado` string
    - `cidade` string
    - `grau_instrucao` string
    - `curso` string
    - `ano_conclusao` integer
    - `email` string
    - `imobiliaria` string
    - `categoria` string
    - `nivel` string
    - `participa_roleta_online` string
    - `classificacao` string
    - `codigointerno` string
    - `identificador` string
    - `profissional_experiencia_ramo_imobiliario` string
    - `profissional_quanto_tempo` string
    - `profissional_ultima_atual_empresa` string
    - `profissional_segmento` string
    - `profissional_data_inicio` string
    - `profissional_data_fim` string
    - `profissional_motivo_saida` string
    - `profissional_superior_imediato` string
    - `profissional_telefone` string
    - `profissional_cargo_inicial` string
    - `profissional_cargo_final` string
    - `profissional_descricao_atividades` string
    - `profissional_ultimos_atuais_ganhos` string
    - `profissional_expectativa_ganhos` string
    - `tipo_creci` string
    - `creci` string
    - `situacao_creci` string
    - `estado_creci` string
    - `cidade_creci` string
    - `vencimento_creci` string
    - `tipo_conta` string
    - `banco` string
    - `nome_agencia` string
    - `numero_agencia` string
    - `digito_agencia` string
    - `numero_conta` string
    - `digito_conta` string
    - `cpf_favorecido` string
    - `nome_favorecido` string
    - `cnpj` string
    - `inscricao_municipal` string
    - `ju_cep` string
    - `ju_logradouro` string
    - `ju_endereco` string
    - `ju_bairro` string
    - `ju_numero` string
    - `ju_complemento` string
    - `ju_estado` string
    - `ju_cidade` string
    - `cnpj_faturamento` string
    - `razaosocial_faturamento` string
    - `nomefantasia_faturamento` string
    - `representante_nome` string
    - `representante_telefone` string
    - `representante_celular` string
    - `representante_email` string
    - `representante_rg` string
    - `representante_documento` string
    - `representante_creci` string
    - `representante_vencimento_creci` string
    - `representante_data_nasc` string
    - `representante_quantidade_filhos` string
    - `banco_tipo_doc` string
    - `banco_cpf_titular` string
    - `banco_cnpj_titular` string
    - `data_ult_hist` string — Data da último historico

---

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