Skip to main content
POST
/
v1
/
query
/
cnpj-basic
Dados básicos PJ (CNPJ)
curl --request POST \
  --url https://proteo-data.ngrok.app/v1/query/cnpj-basic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "document": "11222333000181"
}
'
{
  "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"
  }
}

Authorizations

Authorization
string
header
required

API Key no formato Bearer (mesmo valor da chave gerada no painel).

Body

application/json
document
string
required

Identificador da consulta. Depende do produto: ex. cpf-basic / cpf-kyc — 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.

Required string length: 1 - 100

Response

Consulta concluída

Consulta concluída

data
object
required

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.

meta
object
required

Metadados da cobrança e rastreio (sem detalhes de infraestrutura).