# Consulta

Operações de consulta direta para pessoas físicas (CPF), empresas (CNPJ), validação de WhatsApp e verificação de saldo.


## Consultar saldo da conta

 - [GET /balance](https://docs.datastone.com.br/api/consulta/get_balance.md): Retorna informações de saldo e créditos disponíveis na conta por produto

## Consultar informações de pessoas físicas

 - [GET /persons](https://docs.datastone.com.br/api/consulta/get_persons.md): Busca informações detalhadas de pessoa física por CPF

## Busca avançada de pessoas

 - [GET /persons/search](https://docs.datastone.com.br/api/consulta/get_persons_search.md): Buscar pessoas por nome, email, telefone, nome da mãe ou endereço.

Permite buscas mais flexíveis sem necessidade de CPF.

## Busca de pessoas com wildcard

 - [GET /persons/advanced-search](https://docs.datastone.com.br/api/consulta/get_persons_advanced_search.md): Busca por nome com suporte a caractere curinga (*).

Use o asterisco (*) para representar qualquer sequência de caracteres.

Exemplo: name=JOAO*SILVA encontra "JOAO DA SILVA", "JOAO PEDRO SILVA", etc.

## Consultar informações de empresas

 - [GET /companies](https://docs.datastone.com.br/api/consulta/get_companies.md): Busca informações detalhadas de empresa por CNPJ

## Buscar empresas

 - [GET /company/list](https://docs.datastone.com.br/api/consulta/get_company_list.md): Buscar empresas por razão social, email, domínio, CEP ou telefone.

Permite buscas sem necessidade de CNPJ.

## Buscar matriz e filiais

 - [GET /company/search/filial](https://docs.datastone.com.br/api/consulta/get_company_filial.md): Localizar matriz e todas as filiais de uma empresa a partir de qualquer CNPJ do grupo.

Retorna informações de todas as unidades (matriz + filiais).

## Validar status de contato WhatsApp

 - [GET /whatsapp/search](https://docs.datastone.com.br/api/consulta/get_whatsapp_status.md): Verifica se um número de telefone está ativo no WhatsApp.

IMPORTANTE: Os campos ddd e phone devem ser enviados separadamente, sem formatação (sem traços ou espaços).

## Validar múltiplos números WhatsApp

 - [POST /whatsapp/batch](https://docs.datastone.com.br/api/consulta/post_whatsapp_batch.md): Verifica o status de múltiplos números de telefone no WhatsApp em uma única requisição.

Processamento assíncrono com callback.

Limite: Até 1000 números por requisição