Listar CNPJs consultados
Como listar os CNPJs anteriormente consultados ?
O endpoint responsável pela listagem de CNPJ é: https://api-v2.idwall.co/empresas
, agora basta realizar uma requisição com o método GET
e você irá receber uma resposta com os CNPJs que foram consultados pela sua organização ordenadas pela última atualização de um relatório.
Segue um exemplo de requisição.
curl -X GET https://api-v2.idwall.co/empresas
-H "Content-Type: application/json"
-H 'Authorization:seu-token'
Exemplo de sucesso
{
"result": {
"busca": "",
"itens": [
{
"cnpj": "12345678910111",
"nome": "Nome Empresa A",
"atualizado_em": "2020-06-08T21:31:18.391Z"
},
{
"cnpj": "98765432110111",
"nome": "Nome Empresa B",
"atualizado_em": "2020-06-08T21:29:56.041Z"
},
{
"cnpj": "12365478901111",
"nome": "Nome Empresa C",
"atualizado_em": "2020-06-08T21:28:10.723Z"
},
{
"cnpj": "32145698710111",
"nome": "Nome Empresa D",
"atualizado_em": "2020-06-08T21:28:06.562Z"
}
],
"paginacao": {
"atual": 1,
"linhas": 25,
"total": "4"
}
},
"status_code": 200
}
Exemplo de erro
{
"error": "Unauthorized",
"message": "Falha na autenticação. Por favor verifique o token utilizado e se o acesso foi liberado.",
"status_code": 401
}
Filtros
Você também pode realizar buscas com filtros por meio dos parâmetros passados pela urlencoded
, abaixo segue exemplos de filtros que podem ser utilizados em nossa API.
Paginação e linhas
curl -G https://api-v2.idwall.co/empresas
-H "Content-Type: application/x-www-form-urlencoded"
-H 'Authorization:seu-token'
-d "page=1&rows=25"
o número de linhas precisa ser sempre um múltiplo de 25
Filtro para buscar uma empresa em específico
Pode-se realizar esta busca pelo número do CNPJ onde ele é informado sem o uso de máscara ou pontos.
curl -G https://api-v2.idwall.co/empresas
-H "Content-Type: application/x-www-form-urlencoded"
-H 'Authorization:seu-token'
-d "CNPJ=cnpj_da_empresa_que_deseja_buscar"
curl -G https://api-v2.idwall.co/pessoas
-H "Content-Type: application/x-www-form-urlencoded"
-H 'Authorization:seu-token'
-d "nome=nome_da_pessoa_que_deseja_buscar"
Combinação de filtros
É perfeitamente possível combinar os filtros para ter resultados diferentes com a sua necessidade, abaixo segue uma das possíveis combinações que podem ser utilizadas.
curl -G https://api-v2.idwall.co/empresas
-H "Content-Type: application/x-www-form-urlencoded"
-H 'Authorization:seu-token'
-d "page=1&rows=25&sort=cnpj"
Updated almost 4 years ago