> For the complete documentation index, see [llms.txt](https://outboundpro.gitbook.io/api-v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://outboundpro.gitbook.io/api-v1/lead/buscar-leads.md).

# Buscar leads

## Buscar leads com filtros combinados

> Busca leads por múltiplos critérios — CNPJ, razão social, nome fantasia,\
> status, UF, cidade, porte, CNAE, intervalo de cadastro.\
> \
> Diferente de \[\`lead/list\`]\(#operation/leadList), aceita texto livre\
> (LIKE case-insensitive) em \`razao\_social\` e \`nome\_fantasia\`.\
> \
> \### Casos de uso\
> \- Autocomplete em formulários do seu sistema.\
> \- Pre-cadastro: "essa empresa já existe na nossa base?" antes de\
>   \[\`company/prospect\`]\(#operation/companyProspect).\
> \- Relatórios segmentados (todos os CNAE \`6201\`, todos UF \`SP\`, etc.).<br>

```json
{"openapi":"3.0.3","info":{"title":"OutboundPro API","version":"2.0.0"},"tags":[{"name":"Lead","description":"**Empresas já existentes na sua base** (após enriquecimento via\n[Company](#tag/Company) ou cadastro manual no painel).\n\nO termo \"Lead\" no OutboundPro = \"empresa rastreada por você\". Cada lead tem\nstatus (Novo, Em prospecção, Convertido, etc.), lista vinculada, scoring\nautomático e contatos (sócios) associados.\n\n### Diferença Company × Lead\n- **Company** = empresa pelo CNPJ; consulta a base pública (RFB) do OutboundPro e pode salvar como lead.\n- **Lead** = consulta sua base local; **rápido**, sem lookup externo.\n\nSe você sabe que a empresa já está na sua base, prefira `lead/*` por\nperformance.\n\n### Estrutura típica\n- `id` (`emp_codigo`) ou `hash` (`emp_hash`) — identificadores estáveis.\n- `status` — fluxo configurável por cliente ([Status](#tag/Status)).\n- `lista` — agrupamento ([List](#tag/List)).\n- `contatos` — sócios ([Contact](#tag/Contact)).\n"}],"servers":[{"url":"https://app.outboundpro.com.br/api","description":"Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Token","description":"Chave privada do cliente (`cli_chave_privada`). Formato UUID v4\n(36 caracteres com hífens). Aceita header em qualquer case\n(`Token`, `token`, `TOKEN`).\n"}},"schemas":{"PaginacaoEnvelope":{"type":"object","required":["response","total","pagina","limite","paginas"],"properties":{"response":{"type":"string","enum":["success"]},"total":{"type":"integer","description":"Total geral (ignora paginação)."},"pagina":{"type":"integer","minimum":1},"limite":{"type":"integer","minimum":1,"maximum":100},"paginas":{"type":"integer","description":"Total de páginas considerando `limite` atual."}}},"Lead":{"type":"object","properties":{"id":{"type":"integer"},"hash":{"type":"string"},"cnpj":{"type":"string","description":"14 dígitos, sem máscara"},"razao_social":{"type":"string"},"nome_fantasia":{"type":"string"},"porte":{"type":"string","description":"ME, EPP, DEMAIS conforme classificação Receita"},"natureza_juridica":{"type":"string"},"uf":{"type":"string","minLength":2,"maxLength":2},"cidade":{"type":"string"},"cnae_principal":{"type":"string"},"cnae_principal_descricao":{"type":"string"},"data_cadastro":{"type":"string","format":"date-time"},"status":{"type":"string","description":"Nome do status atual (ex.: Não prospectado, Em prospecção, Convertido)."},"status_id":{"type":"integer","description":"ID do status para joining com [Status.list](#operation/statusList)."}}},"ErrorResponse":{"type":"object","required":["response"],"properties":{"response":{"type":"string","enum":["error"]},"mensagem":{"type":"string","description":"Descrição do erro em pt-BR. Família Contact usa `message` (legado)."},"message":{"type":"string","description":"Equivalente inglês de `mensagem`, usado pela família Contact."}}}},"responses":{"Unauthorized":{"description":"Token ausente, inválido ou cliente inativo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/lead/search":{"get":{"tags":["Lead"],"summary":"Buscar leads com filtros combinados","operationId":"leadSearch","description":"Busca leads por múltiplos critérios — CNPJ, razão social, nome fantasia,\nstatus, UF, cidade, porte, CNAE, intervalo de cadastro.\n\nDiferente de [`lead/list`](#operation/leadList), aceita texto livre\n(LIKE case-insensitive) em `razao_social` e `nome_fantasia`.\n\n### Casos de uso\n- Autocomplete em formulários do seu sistema.\n- Pre-cadastro: \"essa empresa já existe na nossa base?\" antes de\n  [`company/prospect`](#operation/companyProspect).\n- Relatórios segmentados (todos os CNAE `6201`, todos UF `SP`, etc.).\n","parameters":[{"in":"query","name":"pagina","schema":{"type":"integer","default":1,"minimum":1}},{"in":"query","name":"limite","schema":{"type":"integer","default":50,"minimum":1,"maximum":100}},{"in":"query","name":"ordenacao","schema":{"type":"string","default":"emp_data_cadastro"}},{"in":"query","name":"direcao","schema":{"type":"string","enum":["ASC","DESC"],"default":"DESC"}},{"in":"query","name":"cnpj","schema":{"type":"string"},"description":"Filtro exato — CNPJ sem máscara."},{"in":"query","name":"razao_social","schema":{"type":"string"},"description":"Busca parcial (LIKE %valor%) case-insensitive."},{"in":"query","name":"nome_fantasia","schema":{"type":"string"},"description":"Mesmo padrão de `razao_social`."},{"in":"query","name":"status","schema":{"type":"string"},"description":"Nome do status."},{"in":"query","name":"uf","schema":{"type":"string","minLength":2,"maxLength":2}},{"in":"query","name":"cidade","schema":{"type":"string"}},{"in":"query","name":"porte","schema":{"type":"string"},"description":"ME, EPP, DEMAIS."},{"in":"query","name":"cnae","schema":{"type":"string"},"description":"Código completo (`6201-5/01`) ou parcial (`6201`)."},{"in":"query","name":"data_inicial","schema":{"type":"string","format":"date"}},{"in":"query","name":"data_final","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Resultados paginados.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginacaoEnvelope"},{"type":"object","properties":{"leads":{"type":"array","items":{"$ref":"#/components/schemas/Lead"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```