Skip to main content
POST
https://localapi.lazydata.com.br
/
v1
/
search
/
company
Busca por CNPJ
curl --request POST \
  --url https://localapi.lazydata.com.br/v1/search/company \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "taxid": "<string>",
  "datasets": [
    "<string>"
  ],
  "additional": {},
  "mode": "<string>"
}
'
{
  "code": 200,
  "message": "Consulta realizada com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "completed",
    "target": "company",
    "query": {
      "taxid": "00000000000000",
      "datasets": ["company_basic_data"],
      "additional": {}
    },
    "cost": {
      "total": 0.05,
      "refunded": 0,
      "datasets": {
        "company_basic_data": {
          "charged": 0.05,
          "refunded": 0
        }
      }
    },
    "timing": {
      "total": 0.42,
      "datasets": {
        "company_basic_data": 0.42
      }
    },
    "errors": {},
    "datasets_status": {
      "company_basic_data": "completed"
    },
    "result": {
      "company_basic_data": {
        "tax_id": "00000000000000",
        "name": "EMPRESA EXEMPLO LTDA",
        "fantasy_name": "EXEMPLO",
        "status": "ATIVA",
        "opening_date": "2020-01-15"
      }
    },
    "created_at": "2026-06-22T12:00:00Z",
    "last_updated_at": "2026-06-22T12:00:01Z"
  }
}
Executa uma consulta de pessoa jurídica por CNPJ usando os datasets informados no corpo da requisição. Essa consulta pode ser executada em modo síncrono ou assíncrono. No modo assíncrono, a API retorna um id para acompanhamento posterior do resultado. 
{
  "code": 200,
  "message": "Consulta realizada com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "completed",
    "target": "company",
    "query": {
      "taxid": "00000000000000",
      "datasets": ["company_basic_data"],
      "additional": {}
    },
    "cost": {
      "total": 0.05,
      "refunded": 0,
      "datasets": {
        "company_basic_data": {
          "charged": 0.05,
          "refunded": 0
        }
      }
    },
    "timing": {
      "total": 0.42,
      "datasets": {
        "company_basic_data": 0.42
      }
    },
    "errors": {},
    "datasets_status": {
      "company_basic_data": "completed"
    },
    "result": {
      "company_basic_data": {
        "tax_id": "00000000000000",
        "name": "EMPRESA EXEMPLO LTDA",
        "fantasy_name": "EXEMPLO",
        "status": "ATIVA",
        "opening_date": "2020-01-15"
      }
    },
    "created_at": "2026-06-22T12:00:00Z",
    "last_updated_at": "2026-06-22T12:00:01Z"
  }
}

​
Corpo da requisição

​
taxid
string
required
CNPJ da empresa consultada. Pontuação é aceita e removida automaticamente.
​
datasets
string[]
required
Lista de IDs dos datasets que serão consultados.
​
additional
object
Dados adicionais por dataset, quando algum dataset exigir parâmetros extras.
​
mode
string
default:"async"
Modo da consulta.
Valores aceitos para mode:
ValorDescrição
asyncInicia a consulta e retorna um id para acompanhar o resultado depois.
syncAguarda a conclusão da consulta e retorna os dados diretamente na resposta.
​
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.

​
Exemplo de corpo

{
  "taxid": "00000000000000",
  "mode": "async",
  "datasets": ["company_basic_data"],
  "additional": {}
}
O CNPJ acima é fictício e serve apenas para demonstrar a estrutura da requisição. Em chamadas reais ou sandbox, informe um CNPJ válido para o ambiente utilizado.

​
Parâmetros adicionais por dataset

Alguns datasets podem exigir campos adicionais. Consulte additional_fields em Datasets e preços para saber quais campos devem ser enviados. Exemplo de envio de dados adicionais: 
{
  "taxid": "00000000000000",
  "mode": "async",
  "datasets": ["company_example_dataset"],
  "additional": {
    "company_example_dataset": {
      "state": "SP"
    }
  }
}

​
Resposta

​
code
integer
required
Código da resposta da API.
​
message
string
required
Mensagem descritiva da resposta.
​
result
object
required
Objeto principal da consulta. A estrutura varia de acordo com o modo de execução.

​
Retorno síncrono

Quando mode é sync, a resposta pode retornar code: 200 com os dados completos da consulta.

​
Estrutura de result

CampoTipoDescrição
idstringIdentificador único da consulta.
statusstringStatus final da consulta. Normalmente completed.
targetstringTipo da consulta. Para esta rota, retorna company.
queryobjectDados usados na consulta.
costobjectValores cobrados e estornados.
timingobjectTempo total e tempo individual por dataset.
errorsobjectErros por dataset, quando ocorrerem.
datasets_statusobjectStatus individual de cada dataset.
resultobjectResultado agrupado por dataset.
created_atstringData de criação da consulta em ISO 8601.
last_updated_atstringData da última atualização da consulta em ISO 8601.

​
Retorno assíncrono

Quando mode é async, a resposta inicial retorna code: 202 e o processamento continua em segundo plano. Status possíveis:
StatusDescrição
queuedConsulta criada e aguardando processamento.
processingConsulta em processamento.
completedConsulta finalizada com sucesso.
failedConsulta finalizada com falha.
Para consultar o resultado final, use o id retornado no endpoint de resultado assíncrono.
Campos descritos na estrutura do dataset podem não ser retornados em todas as consultas. Alguns dados dependem da disponibilidade da fonte e do CNPJ consultado.

​
Fluxo recomendado

  1. Liste os datasets disponíveis em Datasets e preços.
  2. Selecione apenas datasets com active: true.
  3. Envie o CNPJ, os datasets e os campos adicionais necessários.
  4. Use mode: "async" para consultas com múltiplos datasets ou fontes online.
  5. Consulte o resultado pelo id retornado quando a chamada for assíncrona.