Skip to main content
POST
https://localapi.lazydata.com.br
/
v1
/
search
/
company
/
phone
Busca por telefone
curl --request POST \
  --url https://localapi.lazydata.com.br/v1/search/company/phone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "<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 telefone com DDD. Use esta rota quando você possui um telefone 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

​
phone
string
required
Telefone com DDD. Pontuação é aceita e removida automaticamente.
​
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 telefone

O telefone deve conter DDD e 10 ou 11 dígitos após normalização. O prefixo internacional 55 é aceito e removido automaticamente quando informado.

​
Exemplo de corpo

{
  "phone": "1133334444",
  "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 telefone 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 telefone informado e dos dados existentes para os registros encontrados.

​
Paginação

Quando has_more retornar true, envie a mesma requisição incrementando page. 
{
  "phone": "1133334444",
  "page": 2
}

​
Respostas esperadas

StatusQuando ocorre
200Busca executada com sucesso.
400Requisição inválida, telefone ausente ou telefone 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 o telefone com DDD.
  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.