curl --request POST \
--url https://data.proteodata.com.br/v1/query/cnpj-basic \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document": "11222333000181"
}
'import requests
url = "https://data.proteodata.com.br/v1/query/cnpj-basic"
payload = { "document": "11222333000181" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({document: '11222333000181'})
};
fetch('https://data.proteodata.com.br/v1/query/cnpj-basic', 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://data.proteodata.com.br/v1/query/cnpj-basic",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'document' => '11222333000181'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://data.proteodata.com.br/v1/query/cnpj-basic"
payload := strings.NewReader("{\n \"document\": \"11222333000181\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://data.proteodata.com.br/v1/query/cnpj-basic")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"document\": \"11222333000181\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.proteodata.com.br/v1/query/cnpj-basic")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"document\": \"11222333000181\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"MatchKeys": "doc{12***890001**}",
"BasicData": {
"TaxIdNumber": "12***890001**",
"TaxIdCountry": "Brazil",
"AlternativeIdNumbers": {},
"OfficialName": "EMPRESA *** SOLUCOES LTDA",
"TradeName": "EMPRESA ***",
"Aliases": {
"UnstandardizedRFOfficialName": "EMPRESA *** SOLUCOES LTDA",
"UnstandardizedRFTradeName": "EMPRESA ***"
},
"NameUniquenessScore": 1,
"OfficialNameUniquenessScore": 1,
"TradeNameUniquenessScore": -1,
"FoundedDate": "2023-07-18T00:00:00Z",
"Age": 3,
"IsHeadquarter": true,
"HeadquarterState": "PR",
"IsConglomerate": false,
"TaxIdStatus": "ATIVA",
"TaxIdStatusReason": "",
"TaxIdOrigin": "Receita Federal",
"TaxIdStatusDate": "2026-03-20T00:00:00Z",
"TaxIdStatusRegistrationDate": "2023-07-18T00:00:00Z",
"TaxRegime": "SIMPLES",
"CompanyType_ReceitaFederal": "ME",
"TaxRegimes": {
"Simples": true
},
"Activities": [
{
"IsMain": true,
"Code": "6201501",
"Activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
"ActivityDivision": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityGroup": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityClass": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA"
},
{
"IsMain": false,
"Code": "6202300",
"Activity": "DESENVOLVIMENTO E LICENCIAMENTO DE PROGRAMAS DE COMPUTADOR CUSTOMIZAVEIS",
"ActivityDivision": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityGroup": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityClass": "DESENVOLVIMENTO E LICENCIAMENTO DE PROGRAMAS DE COMPUTADOR CUSTOMIZAVEIS"
},
{
"IsMain": false,
"Code": "6204000",
"Activity": "CONSULTORIA EM TECNOLOGIA DA INFORMACAO",
"ActivityDivision": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityGroup": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityClass": "CONSULTORIA EM TECNOLOGIA DA INFORMACAO"
}
],
"LegalNature": {
"Code": "2062",
"Activity": "SOCIEDADE EMPRESARIA LIMITADA"
},
"SpecialSituation": "",
"CreationDate": "2023-07-19T00:00:00Z",
"LastUpdateDate": "2026-03-20T00:00:00Z",
"AdditionalOutputData": {
"Capital": "CINQUENTA MIL REAIS",
"CapitalRS": "50000.00",
"NIRE": "",
"NIRECompanySize": "",
"NIREHeadquartersType": "",
"NIREHeadquartersCapital": "0",
"NIRELastCaptureDate": "0001-01-01T12:00:00Z",
"COMEX": "",
"COMEXLastUpdate": "0001-01-01T12:00:00Z"
},
"HistoricalData": {
"HasChangedTradeName": false,
"HasChangedTaxRegime": true,
"HistoricalDataEvolution": {
"TradeName": [
{
"Value": "EMPRESA ***",
"StartDate": "2023-07-19T00:00:00Z"
}
],
"TaxRegime": [
{
"Value": "SIMPLES",
"StartDate": "2023-07-01T00:00:00Z"
},
{
"Value": "LTDA",
"StartDate": "2023-07-19T00:00:00Z",
"EndDate": "2023-07-01T00:00:00Z"
}
]
}
}
}
},
"meta": {
"chargedCredits": "0.044800",
"product": "cnpj-basic",
"queryId": "c6f34ca8-186b-4e35-b9f7-f4542fd2d3f2"
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Dados básicos PJ
Consulta de dados básicos de pessoa jurídica pelo CNPJ. Equivalente a POST /v1/query/{slug} com slug = cnpj-basic. Envie o CNPJ com 14 dígitos, apenas números, no campo document; a plataforma não valida dígitos verificadores. Requer API Key ativa e saldo de créditos. Em 200, o corpo traz data (payload do produto) e meta com chargedCredits, product e queryId (identificador interno Proteo para suporte). Guia detalhado: Dados básicos PJ na aba Guias da documentação.
curl --request POST \
--url https://data.proteodata.com.br/v1/query/cnpj-basic \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document": "11222333000181"
}
'import requests
url = "https://data.proteodata.com.br/v1/query/cnpj-basic"
payload = { "document": "11222333000181" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({document: '11222333000181'})
};
fetch('https://data.proteodata.com.br/v1/query/cnpj-basic', 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://data.proteodata.com.br/v1/query/cnpj-basic",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'document' => '11222333000181'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://data.proteodata.com.br/v1/query/cnpj-basic"
payload := strings.NewReader("{\n \"document\": \"11222333000181\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://data.proteodata.com.br/v1/query/cnpj-basic")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"document\": \"11222333000181\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.proteodata.com.br/v1/query/cnpj-basic")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"document\": \"11222333000181\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"MatchKeys": "doc{12***890001**}",
"BasicData": {
"TaxIdNumber": "12***890001**",
"TaxIdCountry": "Brazil",
"AlternativeIdNumbers": {},
"OfficialName": "EMPRESA *** SOLUCOES LTDA",
"TradeName": "EMPRESA ***",
"Aliases": {
"UnstandardizedRFOfficialName": "EMPRESA *** SOLUCOES LTDA",
"UnstandardizedRFTradeName": "EMPRESA ***"
},
"NameUniquenessScore": 1,
"OfficialNameUniquenessScore": 1,
"TradeNameUniquenessScore": -1,
"FoundedDate": "2023-07-18T00:00:00Z",
"Age": 3,
"IsHeadquarter": true,
"HeadquarterState": "PR",
"IsConglomerate": false,
"TaxIdStatus": "ATIVA",
"TaxIdStatusReason": "",
"TaxIdOrigin": "Receita Federal",
"TaxIdStatusDate": "2026-03-20T00:00:00Z",
"TaxIdStatusRegistrationDate": "2023-07-18T00:00:00Z",
"TaxRegime": "SIMPLES",
"CompanyType_ReceitaFederal": "ME",
"TaxRegimes": {
"Simples": true
},
"Activities": [
{
"IsMain": true,
"Code": "6201501",
"Activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
"ActivityDivision": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityGroup": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityClass": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA"
},
{
"IsMain": false,
"Code": "6202300",
"Activity": "DESENVOLVIMENTO E LICENCIAMENTO DE PROGRAMAS DE COMPUTADOR CUSTOMIZAVEIS",
"ActivityDivision": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityGroup": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityClass": "DESENVOLVIMENTO E LICENCIAMENTO DE PROGRAMAS DE COMPUTADOR CUSTOMIZAVEIS"
},
{
"IsMain": false,
"Code": "6204000",
"Activity": "CONSULTORIA EM TECNOLOGIA DA INFORMACAO",
"ActivityDivision": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityGroup": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"ActivityClass": "CONSULTORIA EM TECNOLOGIA DA INFORMACAO"
}
],
"LegalNature": {
"Code": "2062",
"Activity": "SOCIEDADE EMPRESARIA LIMITADA"
},
"SpecialSituation": "",
"CreationDate": "2023-07-19T00:00:00Z",
"LastUpdateDate": "2026-03-20T00:00:00Z",
"AdditionalOutputData": {
"Capital": "CINQUENTA MIL REAIS",
"CapitalRS": "50000.00",
"NIRE": "",
"NIRECompanySize": "",
"NIREHeadquartersType": "",
"NIREHeadquartersCapital": "0",
"NIRELastCaptureDate": "0001-01-01T12:00:00Z",
"COMEX": "",
"COMEXLastUpdate": "0001-01-01T12:00:00Z"
},
"HistoricalData": {
"HasChangedTradeName": false,
"HasChangedTaxRegime": true,
"HistoricalDataEvolution": {
"TradeName": [
{
"Value": "EMPRESA ***",
"StartDate": "2023-07-19T00:00:00Z"
}
],
"TaxRegime": [
{
"Value": "SIMPLES",
"StartDate": "2023-07-01T00:00:00Z"
},
{
"Value": "LTDA",
"StartDate": "2023-07-19T00:00:00Z",
"EndDate": "2023-07-01T00:00:00Z"
}
]
}
}
}
},
"meta": {
"chargedCredits": "0.044800",
"product": "cnpj-basic",
"queryId": "c6f34ca8-186b-4e35-b9f7-f4542fd2d3f2"
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
API Key no formato Bearer (mesmo valor da chave gerada no painel).
Body
Identificador da consulta. Depende do produto: ex. cpf-basic / cpf-kyc / cpf-kyc-relatives / cpf-betting-compliance — CPF com 11 dígitos; cnpj-basic / cnpj-kyc — CNPJ com 14 dígitos; apenas números. A API não valida dígitos verificadores; formatos inválidos podem falhar na origem.
1 - 100Response
Consulta concluída
Consulta concluída
Payload do produto. Normalmente é o primeiro elemento do array Result quando a resposta do fornecedor segue esse formato. Se a origem responder com sucesso e Result for um array vazio, data pode incluir Result, Status, QueryId, ElapsedMilliseconds, QueryDate e Evidences. Sem transformação no produto, pode ser o JSON bruto. Pode ser null quando não há item útil a extrair.
Metadados da cobrança e rastreio (sem detalhes de infraestrutura).
Show child attributes
Show child attributes