Skip to main content
POST
https://localapi.lazydata.com.br
/
v1
/
search
/
company
/
email
Busca por e-mail
curl --request POST \
  --url https://localapi.lazydata.com.br/v1/search/company/email \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "page": 123
}
'
{
  "code": 200,
  "message": "Consulta realizada com sucesso.",
  "result": {
    "items": [
      {
        "taxid": "00.000.000/0000-00",
        "name": "EMPRESA EXEMPLO LTDA",
        "location": "São Paulo/SP",
        "status": "ATIVA",
        "activity_start_date": "2020-01-15"
      }
    ],
    "has_more": false,
    "page": 1,
    "price": 0.09,
    "charged": 0.09,
    "debit_only_if_found": false,
    "time": 0.42,
    "test": false
  }
}
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. 
{
  "code": 200,
  "message": "Consulta realizada com sucesso.",
  "result": {
    "items": [
      {
        "taxid": "00.000.000/0000-00",
        "name": "EMPRESA EXEMPLO LTDA",
        "location": "São Paulo/SP",
        "status": "ATIVA",
        "activity_start_date": "2020-01-15"
      }
    ],
    "has_more": false,
    "page": 1,
    "price": 0.09,
    "charged": 0.09,
    "debit_only_if_found": false,
    "time": 0.42,
    "test": false
  }
}

​
Corpo da requisição

​
email
string
required
E-mail usado na busca. O valor é normalizado para letras minúsculas antes da consulta.
​
page
integer
default:"1"
Página dos resultados. Use a próxima página enquanto has_more for true.
​
x-ambient
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

{
  "email": "contato@example.com",
  "page": 1
}

​
Resposta

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

​
Estrutura de result

CampoTipoDescrição
itemsarray<object>Registros encontrados para o e-mail informado.
has_morebooleanIndica se existe próxima página disponível.
pageintegerPágina retornada.
pricenumberPreço da busca para a conta autenticada.
chargednumberValor debitado nesta chamada. Em sandbox, retorna 0.
debit_only_if_foundbooleanIndica se a cobrança ocorre apenas quando houver resultado útil.
timenumberTempo de execução em segundos.
testbooleanIndica se a chamada foi executada em ambiente de teste.

​
Estrutura de result.items[]

CampoTipoDescrição
taxidstringCNPJ encontrado.
namestringRazão social.
locationstringLocalização resumida, quando disponível.
statusstringSituação cadastral.
activity_start_datestringData de abertura ou início de atividade no formato yyyy-mm-dd, quando disponível.
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. 
{
  "email": "contato@example.com",
  "page": 2
}

​
Respostas esperadas

StatusQuando ocorre
200Busca executada com sucesso.
400Requisição inválida, e-mail ausente ou e-mail em formato incompatível.
401A chave da API está ausente, inválida ou não pôde ser autenticada.
403A credencial não possui escopo de consulta, o plano não permite acesso ou há bloqueio financeiro.

​
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.