Listar produção própria

GET /leads

Lista, paginada, a produção (leads) que o próprio parceiro originou via esta API. Escopada
pelo parceiro autenticado a partir do token — nunca é possível ver produção de outro parceiro,
nem produção originada fora desta integração (ex.: Portal do Parceiro), em nenhuma combinação
de filtros.

Query params

ParamTipoObrigatórioRegras
realEstateCnpjstringNãoExatamente 14 dígitos, sem pontuação, CNPJ válido — restringe a uma imobiliária, dentro da própria produção
idApplicationstringNãoIdentificador do lead — busca direta
creIdstringNãoCRE-ID do corretor
cpfstringNãoCPF do lead — 11 dígitos, formatado ou não (12345678901 ou 123.456.789-01)
zipcodestringNãoCEP do imóvel — 8 dígitos, formatado ou não (01310100 ou 01310-100)
pageintegerNãoDefault 0. Mínimo 0
pageSizeintegerNãoDefault 20. Entre 1 e 100

Filtros se combinam (E lógico). Parâmetro presente e vazio (?cpf=) é tratado como ausente.

cpf e zipcode aceitam máscara; realEstateCnpj não. Divergência real do contrato —
os dois primeiros espelham a validação do serviço interno, que aceita as duas formas; o CNPJ
exige dígitos puros. Envie CNPJ sem pontuação.

Sucesso — 200 OK

{
  "items": [
    {
      "idApplication": "rentals_abc123",
      "profileAnalysisId": "rentals_pa_abc123xyz",
      "idProtocol": "PROTO-0001",
      "applicationStatus": "APPROVED",
      "product": "RENT_GUARANTEE",
      "createDate": "2026-09-01T12:00:00Z",
      "realEstateCnpj": "11444777000161",
      "realEstateName": "Real Estate Ltda.",
      "rentAmount": 2500.0,
      "contractStartDate": "2026-10-01",
      "closingDate": null
    }
  ],
  "hasNext": true
}
CampoTipoDescrição
items[].idApplicationstringIdentificador do lead — mesmo idApplication retornado por 6.2
items[].profileAnalysisIdstring | nullpreProfileAnalysisId de origem
items[].idProtocolstring | nullProtocolo interno, quando existente
items[].applicationStatusstringStatus interno da aplicação. Conjunto aberto — trate valor desconhecido defensivamente (seção 4); não é o mesmo enum fechado de decision em 6.2
items[].productstringProduto de origem do lead
items[].createDatestring (timestamp) | nullData de criação
items[].realEstateCnpjstring | nullCNPJ da imobiliária dona do lead
items[].realEstateNamestring | nullNome da imobiliária
items[].rentAmountnumber | nullValor do aluguel informado na originação
items[].contractStartDatestring (date) | nullData de início do contrato, quando já definida (objeto completo em 6.14)
items[].closingDatestring (timestamp) | nullData de fechamento, quando aplicável
hasNextbooleanIndica se há próxima página

Paginação por offset, não por cursor. Divergência consciente do padrão desta API (a
paginação de 8.10 usa cursor) — dívida técnica assumida conscientemente para não introduzir
tradução de cursor nesta entrega. A resposta não traz totalElements/totalPages, só
hasNext. Para percorrer tudo, incremente page até hasNext vir false.

Só produção via API. Produção originada no Portal do Parceiro não aparece aqui, mesmo que
seja de uma imobiliária da sua rede.

Erros mapeados

HTTPcodeQuando ocorre
400LEAD_QUERY_INVALIDQualquer filtro inválido: page/pageSize fora dos limites, ou realEstateCnpj/cpf/zipcode com formato inválido. details[] aponta o campo
500LEAD_INTEGRATION_FAILUREFalha de comunicação interna — repetir com backoff