> ## Documentation Index > Fetch the complete documentation index at: https://docs.proteodata.com.br/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi.json post /v1/query/cnpj-basic openapi: 3.0.3 info: title: Proteo Data API description: >- Referência das consultas por produto, agrupadas por domínio (pessoa física, jurídica, veículos). Rotas do portal e monitorização não fazem parte deste documento. version: 1.0.0 servers: - url: https://data.proteodata.com.br description: Produção — URL pública - url: https://data.qa.proteodata.com.br description: Homologação — URL pública - url: https://data.dev.proteodata.com.br description: Desenvolvimento — URL pública security: [] tags: - name: Pessoa física description: >- Consultas por CPF e dados de pessoa física. Autenticação: `Authorization: Bearer `. Guias: **Dados básicos PF** (`cpf-basic`); **KYC e compliance PF** (`cpf-kyc`); **KYC familiares de 1º nível PF** (`cpf-kyc-relatives`); **Compliance casas de apostas PF** (`cpf-betting-compliance`). - name: Pessoa jurídica description: >- Consultas por CNPJ e dados de pessoa jurídica. Autenticação: `Authorization: Bearer `. Guias: **Dados básicos PJ** (`cnpj-basic`); **KYC e compliance PJ** (`cnpj-kyc`). - name: Veículos description: >- Consultas veiculares (ex.: placa). Autenticação: `Authorization: Bearer `. paths: /v1/query/cnpj-basic: post: tags: - Pessoa jurídica summary: Dados básicos PJ description: >- 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. operationId: consultaDadosBasicosPj requestBody: content: application/json: schema: type: object properties: document: type: string minLength: 1 maxLength: 100 description: >- 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. required: - document additionalProperties: false example: document: '11222333000181' required: true responses: '200': description: Consulta concluída content: application/json: schema: description: Consulta concluída type: object properties: data: description: >- 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. type: object nullable: true additionalProperties: true meta: type: object description: >- Metadados da cobrança e rastreio (sem detalhes de infraestrutura). properties: chargedCredits: type: string description: >- Valor em R$ debitado nesta chamada (string decimal, ex.: 6 casas). product: type: string description: Slug do produto consultado. queryId: type: string format: uuid description: >- Identificador interno da consulta na Proteo (QueryLog); informe em chamados de suporte. required: - chargedCredits - product - queryId required: - data - meta example: 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 '400': description: 'Corpo JSON inválido ou fora do schema (`error`: `VALIDATION_ERROR`)' content: application/json: schema: description: >- Corpo JSON inválido ou fora do schema (`error`: `VALIDATION_ERROR`) type: object properties: error: type: string description: Código do erro message: type: string description: Mensagem legível required: - error - message '401': description: API Key ausente ou inválida content: application/json: schema: description: API Key ausente ou inválida type: object properties: error: type: string description: Código do erro message: type: string description: Mensagem legível required: - error - message '402': description: >- Saldo insuficiente (`INSUFFICIENT_CREDITS`) ou limite pós-pago atingido (`POSTPAID_LIMIT_REACHED`) content: application/json: schema: description: >- Saldo insuficiente (`INSUFFICIENT_CREDITS`) ou limite pós-pago atingido (`POSTPAID_LIMIT_REACHED`) type: object properties: error: type: string description: Código do erro message: type: string description: Mensagem legível required: - error - message '403': description: Instituição bloqueada (`TENANT_BLOCKED`) content: application/json: schema: description: Instituição bloqueada (`TENANT_BLOCKED`) type: object properties: error: type: string description: Código do erro message: type: string description: Mensagem legível required: - error - message '404': description: Produto inexistente, inativo ou sem preço para o plano content: application/json: schema: description: Produto inexistente, inativo ou sem preço para o plano type: object properties: error: type: string description: Código do erro message: type: string description: Mensagem legível required: - error - message '502': description: Falha ao obter o resultado da consulta na origem content: application/json: schema: description: Falha ao obter o resultado da consulta na origem type: object properties: error: type: string description: Código do erro message: type: string description: Mensagem legível required: - error - message security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: API Key no formato Bearer (mesmo valor da chave gerada no painel). ````