Pessoa Jurídica
Identificar empresas por telefone
Busca reversa: identifica empresas que possuem o telefone informado no cadastro da Receita Federal. Retorna o perfil completo de cada empresa. O array socios nao e populado neste endpoint (use /empresas/cnpj/ ou /empresas/cpf/ para o quadro societario).
GET
/
empresas
/
telefone
/
{telefone}
Identificar empresas por telefone
curl --request GET \
--url 'https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token='import requests
url = "https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token="
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token="
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token=")
.asString();require 'uri'
require 'net/http'
url = URI("https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"empresas": [
{
"documento": "12.345.678/0001-99",
"tipo_documento": "CNPJ",
"cnpj_basico": "12345678",
"razao_social": "Empresa Exemplo Ltda",
"nome_fantasia": "Exemplo",
"situacao": "Ativa",
"data_situacao": "2010-05-20",
"capital_social": 100000,
"porte": "Empresa de Pequeno Porte",
"matriz_filial": "Matriz",
"natureza_juridica": {
"codigo": "2062",
"descricao": "Sociedade Empresária Limitada"
},
"atividade_principal": {
"codigo": "4729199",
"descricao": "Comércio varejista de outros produtos"
},
"atividades_secundarias": [],
"endereco": {
"logradouro": "Rua Exemplo",
"numero": "100",
"complemento": null,
"bairro": "Centro",
"cidade": "São Paulo",
"uf": "SP",
"cep": "01000000"
},
"telefones": [
{
"ddi": "55",
"ddd": "11",
"numero": "33334444",
"numero_completo": "551133334444",
"estado": "SP",
"operadora": "Fixo"
}
],
"emails": [
{
"email": "contato@empresa.com.br",
"dominio": "empresa.com.br",
"corporativo": true
}
],
"socios": [],
"situacao_especial": null,
"data_situacao_especial": null
}
]
}{
"success": false,
"erro": {
"codigo": "VALIDATION_ERROR",
"mensagem": "CPF invalido"
}
}{
"success": false,
"erro": {
"codigo": "VALIDATION_ERROR",
"mensagem": "CPF invalido"
}
}Authorizations
Path Parameters
Telefone com DDD (10-11 digitos)
Example:
"11999998888"
Query Parameters
Maximo de registros retornados (max 200, padrao 50)
Required range:
x <= 200Example:
50
Numero de registros a pular (padrao 0)
Example:
0
Response
Empresas encontradas (perfil completo, socios vazio)
Show child attributes
Show child attributes
⌘I
Identificar empresas por telefone
curl --request GET \
--url 'https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token='import requests
url = "https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token="
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token="
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token=")
.asString();require 'uri'
require 'net/http'
url = URI("https://221b-api.sherlocker.com.br/api/v1/empresas/telefone/{telefone}?token=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"empresas": [
{
"documento": "12.345.678/0001-99",
"tipo_documento": "CNPJ",
"cnpj_basico": "12345678",
"razao_social": "Empresa Exemplo Ltda",
"nome_fantasia": "Exemplo",
"situacao": "Ativa",
"data_situacao": "2010-05-20",
"capital_social": 100000,
"porte": "Empresa de Pequeno Porte",
"matriz_filial": "Matriz",
"natureza_juridica": {
"codigo": "2062",
"descricao": "Sociedade Empresária Limitada"
},
"atividade_principal": {
"codigo": "4729199",
"descricao": "Comércio varejista de outros produtos"
},
"atividades_secundarias": [],
"endereco": {
"logradouro": "Rua Exemplo",
"numero": "100",
"complemento": null,
"bairro": "Centro",
"cidade": "São Paulo",
"uf": "SP",
"cep": "01000000"
},
"telefones": [
{
"ddi": "55",
"ddd": "11",
"numero": "33334444",
"numero_completo": "551133334444",
"estado": "SP",
"operadora": "Fixo"
}
],
"emails": [
{
"email": "contato@empresa.com.br",
"dominio": "empresa.com.br",
"corporativo": true
}
],
"socios": [],
"situacao_especial": null,
"data_situacao_especial": null
}
]
}{
"success": false,
"erro": {
"codigo": "VALIDATION_ERROR",
"mensagem": "CPF invalido"
}
}{
"success": false,
"erro": {
"codigo": "VALIDATION_ERROR",
"mensagem": "CPF invalido"
}
}