---
title: "Retorna um ou vários corretores."
method: GET
path: "/cadastros/corretores"
tags: ["Corretor"]
---

# Retorna um ou vários corretores.

`GET /cadastros/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 serve como um informativo ao sistema legado acerca dos corretores cadastrados no Construtor de Vendas, neste caso do tipo “get”, o usuário não envia informações além da autenticação, a resposta são os dados buscados. A requisição pode retornar um objeto com dados de determinado corretor ou um array com os dados de todos os corretores, dependendo do parâmetro passado na URL.

## Query parameters

- `id` integer
- `documento` string
- `nome` string
- `documento_faturamento` string
- `limit` integer
- `offset` integer

## Headers

- `email` string, required — E-mail para autenticação do usuário em retorno de corretor(es)
- `token` string, required — Tken para autenticação do usuário em retorno de corretor(es)

## Response `200`

Corretor

- ResponseCorretor — Retorna no formato JSON informações de um ou vários corretores.
  - `codigo` string
  - `limit` integer
  - `offset` integer
  - `corretor` object[] — O nome do campo pode variar, retornando **corretor** em formato de array de objetos se o id for informado na url ou pode retornar **corretores** em formato de array de objetos se o id não for informado.
    - `idcorretor` string
    - `nome` string
    - `email` string
    - `documento` string — Documento do corretor sem máscara (somente números).
    - `tipo_corretor` string — Tipo de pessoa do corretor. F - Pessoa Física | J - Pessoa Jurídica.
    - `idcorretor_int` string — Código interno do corretor no sistema legado.
    - `cnpj_faturamento` string — CNPJ de faturamento do corretor. Somente números. Preenchido apenas para corretor PJ.
    - `nome_fantasia` string — Nome fantasia do corretor. Para PJ usa o apelido; para PF usa o nomefantasia_faturamento.
    - `telefone` string — Telefone do corretor. Para PJ retorna o telefone do representante; para PF retorna o telefone direto.
    - `idimobiliaria` string
    - `ativo_login` string
    - `apelido` string
    - `genero` string
    - `estado_civil` string
    - `data_de_nascimento` string
    - `data_nasc` string — Data de nascimento do corretor no formato original do banco (YYYY-MM-DD).
    - `celular` string
    - `rg` string
    - `rg_orgao_expedidor` string
    - `numero_pis` string
    - `cracha` string
    - `naturalidade` string
    - `nacionalidade` string
    - `quantidade_filhos` integer
    - `dependentes` string
    - `tamanho_camisa` string
    - `observacoes` string
    - `nivel` string
    - `categoria` string
    - `time` string
    - `idtime` integer
    - `corretor_parceiro` string
    - `notificar_novos_leads` string
    - `receber_email_leads_a_vencer` string
    - `data_cad` string
    - `imagem_perfil` ImagemPerfil[]
      - `avatar_nome` string — Nome do arquivo
      - `avatar_servidor` string — Nome do arquivo no servidor
      - `avatar_tipo` string — Tipo do arquivo
      - `avatar_tamanho` string — Tamanho do arquivo
      - `avatar_imagem` string — Caminho do arquivo
    - `endereco` Endereco[]
      - `cep` string
      - `logradouro` integer — ID do logradouro do endereço do corretor.
      - `logradouro_nome` string — Nome do logradouro do endereço do corretor.
      - `endereco` string
      - `bairro` string
      - `numero` string
      - `complemento` string
      - `cidade` string
      - `estado` string
      - `pais` string
    - `formacao_academica` string — NI - Nenhum | EFI - Ensino fundamental incompleto | EFC - Ensino fundamental completo | EMI - Ensino médio incompleto | EMC - Ensino médio completo | ESI - Ensino superior completo | PG - Pós-graduação | MS - Mestrado | DR - Doutorado | PD - pós-doutorado
    - `curso` string
    - `ano_conclusao` string
    - `conhecimento_office` string — Conhecimento em office: BA - Básico | IN - Intermediário | AV - Avançado
    - `conhecimento_email` string — Conhecimento em e-mail: BA - Básico | IN - Intermediário | AV - Avançado
    - `outros_curso_relevantes` string
    - `codigo_interno` string
    - `identificador` string
    - `dados_creci` DadosCreci[]
      - `creci` string
      - `situacao` string — S - Ativo | N - Inativo
      - `tipo` string — E - Estagiário | D - Definitivo
      - `estado_creci` string
      - `cidade_creci` string
      - `vencimento` string
    - `informacoes_bancarias` InformacoesBancarias[]
      - `tipo_de_conta` string — C - Corrente | P - Poupança
      - `banco` string
      - `agencia` string
      - `numero_agencia` integer
      - `digito_agencia` integer
      - `conta` integer
      - `digito_conta` integer
      - `tipo_documento` string — CPF ou CNPJ
      - `cpf_titular` string
      - `favorecido` string
    - `inscricao_estadual` string
    - `imobiliaria` object — Dados da imobiliária vinculada ao corretor.
      - `idimobiliaria` integer — Identificador da imobiliária no CV.
      - `idimobiliaria_int` string — Código interno da imobiliária no sistema legado.
      - `nome_fantasia` string — Nome fantasia da imobiliária.
      - `cnpj` string — CNPJ da imobiliária.
      - `email` string — E-mail da imobiliária.
      - `celular_imobiliaria` string — Celular da imobiliária.
      - `telefone_imobiliaria` string — Telefone da imobiliária.
      - `creci_imobiliaria` string — CRECI da imobiliária.
      - `cep_imobiliaria` string — CEP da imobiliária.
      - `endereco_imobiliaria` string — Endereço da imobiliária.
      - `bairro_imobiliaria` string — Bairro da imobiliária.
      - `cidade_imobiliaria` string — Cidade da imobiliária.
      - `estado_imobiliaria` string — Sigla do estado da imobiliária.

## Other responses

- `422` — Erro interno!

---

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