Skip to main content
POST
Busca por e-mail
Executa uma busca paginada de pessoa jurídica a partir de um endereço de e-mail. Use esta rota quando você possui um e-mail e precisa localizar possíveis empresas relacionadas a ele.

Corpo da requisição

string
required
E-mail usado na busca. O valor é normalizado para letras minúsculas antes da consulta.
integer
default:"1"
Página dos resultados. Use a próxima página enquanto has_more for true.
string
Use sandbox para executar uma chamada de teste sem consumo de saldo.
Para detalhes sobre chamadas de teste, consulte Ambiente de teste.

Regras do e-mail

O campo email deve conter um endereço de e-mail válido. Espaços no início e no fim são removidos automaticamente, e o valor é convertido para letras minúsculas antes da busca.

Exemplo de corpo

Resposta

integer
required
Código da resposta da API.
string
required
Mensagem descritiva da resposta.
object
required
Objeto principal com os registros encontrados, dados de paginação, cobrança e tempo de execução.

Estrutura de result

Estrutura de result.items[]

Campos de items[] podem não ser retornados em todas as consultas. A disponibilidade depende do e-mail informado e dos dados existentes para os registros encontrados.

Paginação

Quando has_more retornar true, envie a mesma requisição incrementando page.

Respostas esperadas

Fluxo recomendado

  1. Informe um endereço de e-mail válido.
  2. Leia items e verifique has_more.
  3. Se has_more for true, consulte a próxima página.
  4. Use x-ambient: sandbox para validar integração sem consumir saldo.