> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.omni-ward.com/llms.txt > Use this file to discover all available pages before exploring further. # CNPJ na Receita Federal on-demand > SERVICE_RFB_PJ_ON_DEMAND · Consulta do CNPJ na Receita Federal > [!NOTE] > > Alias: `SERVICE_RFB_PJ_ON_DEMAND` · Preço: **R\$ 0,50** por consulta Consulta do CNPJ na Receita Federal Execute pelo endpoint único [`POST /v1/services`](https://api-docs.omni-ward.com/api-reference/executar-servicos). Você pode combinar este serviço com outros na mesma chamada, enviando cada identificador uma vez. ## Campos do request | Campo | Obrigatório | Descrição | | - | - | - | | `services` | sim | Inclua `"SERVICE_RFB_PJ_ON_DEMAND"` na lista. | | `cnpj` | sim | CNPJ, com ou sem pontuação. | ## Campos em `result` | Campo | Descrição | Tipo | | - | - | - | | `OnlineCertificates` | | array | | `OnlineCertificates[].Origin` | Fonte dos Dados Entregues. | string | | `OnlineCertificates[].InputParameters` | Parâmetros de entrada. | string | | `OnlineCertificates[].ProtocolNumber` | Número de protocolo da certidão. | string | | `OnlineCertificates[].BaseStatus` | Situação cadastral pela certidão. | string | | `OnlineCertificates[].AdditionalOutputData` | Dados adicionais. | object | | `OnlineCertificates[].AdditionalOutputData.OfficialName` | Razão Social da empresa. | string | | `OnlineCertificates[].AdditionalOutputData.BusinessName` | Nome fantasia da empresa. | string | | `OnlineCertificates[].AdditionalOutputData.FoundingDate` | Data de fundação da empresa. | string | | `OnlineCertificates[].AdditionalOutputData.FederalEntity` | Ente Federativo Responsável. | string | | `OnlineCertificates[].AdditionalOutputData.CompanyType` | Tipo do Estabelecimento (MATRIZ ou FILIAL). | string | | `OnlineCertificates[].AdditionalOutputData.Cnae` | Código da atividade principal. | string | | `OnlineCertificates[].AdditionalOutputData.MainEconomicActivity` | Atividade principal. | string | | `OnlineCertificates[].AdditionalOutputData.LegalNatureCode` | Código de natureza legal. | string | | `OnlineCertificates[].AdditionalOutputData.LegalNature` | Natureza legal. | string | | `OnlineCertificates[].AdditionalOutputData.StatusDate` | Data da situação cadastral. | string | | `OnlineCertificates[].AdditionalOutputData.QueryTime` | Horário da consulta. | string | | `OnlineCertificates[].AdditionalOutputData.SpecialSituation` | Situação especial. | string | | `OnlineCertificates[].AdditionalOutputData.SpecialSituationDate` | Data da situação especial. | string | | `OnlineCertificates[].AdditionalOutputData.StatusReason` | Motivo da situação cadastral. | string | | `OnlineCertificates[].AdditionalOutputData.CompanyType_ReceitaFederal` | Tipo da empresa conforme classificação da Receita Federal. | string | | `OnlineCertificates[].AdditionalOutputData.SecondaryActivity.{n}` | Atividade secundária da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Phone.{n}` | Telefone da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Address.Core.{n}` | Logradouro da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Address.City.{n}` | Cidade da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Address.Complement.{n}` | Complemento do endereço da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Address.Neighborhood.{n}` | Bairro da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Address.Number.{n}` | Número de porta da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Address.State.{n}` | Estado da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Address.ZipCode.{n}` | CEP da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].AdditionalOutputData.Email.{n}` | Email da empresa, com \{n} sendo um índice a partir de 0. | string | | `OnlineCertificates[].QueryDate` | Data de realização da consulta. | string | Todo `result` traz também `outcome`, o resumo da consulta: `clear`, `alert`, `match`, `no_match` ou `not_found`. ```bash cURL theme={null} curl --request POST 'https://api.omni-ward.com/v1/services' \ --header 'Authorization: Bearer $OMNI_WARD_API_KEY' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: $(uuidgen)' \ --data '{ "services": [ "SERVICE_RFB_PJ_ON_DEMAND" ], "cnpj": "00000000000000" }' ``` ```javascript Node.js theme={null} const res = await fetch('https://api.omni-ward.com/v1/services', { method: 'POST', headers: { Authorization: `Bearer ${process.env.OMNI_WARD_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID(), }, body: JSON.stringify({ "services": [ "SERVICE_RFB_PJ_ON_DEMAND" ], "cnpj": "00000000000000" }), }); const { results } = await res.json(); ``` ```python Python theme={null} import os, uuid, requests res = requests.post( "https://api.omni-ward.com/v1/services", headers={"Authorization": f"Bearer {os.environ['OMNI_WARD_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}, json={ "services": [ "SERVICE_RFB_PJ_ON_DEMAND" ], "cnpj": "00000000000000" }, timeout=90, ) results = res.json()["results"] ``` ```php PHP theme={null} $ch = curl_init("https://api.omni-ward.com/v1/services"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("OMNI_WARD_API_KEY"), "Content-Type: application/json", "Idempotency-Key: " . bin2hex(random_bytes(16)), ], CURLOPT_POSTFIELDS => '{"services":["SERVICE_RFB_PJ_ON_DEMAND"],"cnpj":"00000000000000"}', ]); $results = json_decode(curl_exec($ch), true)["results"]; ``` ```java Java theme={null} var body = """ { "services": [ "SERVICE_RFB_PJ_ON_DEMAND" ], "cnpj": "00000000000000" } """; var request = HttpRequest.newBuilder(URI.create("https://api.omni-ward.com/v1/services")) .header("Authorization", "Bearer " + System.getenv("OMNI_WARD_API_KEY")) .header("Content-Type", "application/json") .header("Idempotency-Key", UUID.randomUUID().toString()) .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); ``` ```json 200 theme={null} { "results": [ { "service": "SERVICE_RFB_PJ_ON_DEMAND", "status": { "code": 200, "message": "Success" }, "result": { "OnlineCertificates": [ { "Origin": "Receita-Federal Status", "InputParameters": "doc*****************07}", "ProtocolNumber": "", "BaseStatus": "ATIVA", "AdditionalOutputData": { "OfficialName": "BIG*********************************************.A.", "BusinessName": "BIG*******ORP", "FoundingDate": "03/04/2007", "FederalEntity": "", "CompanyType": "", "Cnae": "62.01-5-01", "MainEconomicActivity": "Desenvolvimento de programas de computador sob encomenda", "LegalNatureCode": "205-4", "LegalNature": "Sociedade Anônima Fechada", "StatusDate": "03/04/2007", "QueryTime": "17:09:15", "SpecialSituation": "", "SpecialSituationDate": "01/01/0001", "StatusReason": "", "CompanyType_ReceitaFederal": "DEMAIS", "SecondaryActivity.0": "62.02-3-00 - Desenvolvimento e licenciamento de programas de computador customizáveis", "SecondaryActivity.1": "62.03-1-00 - Desenvolvimento e licenciamento de programas de computador não-customizáveis", "SecondaryActivity.2": "62.04-0-00 - Consultoria em tecnologia da informação", "SecondaryActivity.3": "62.09-1-00 - Suporte técnico, manutenção e outros serviços em tecnologia da informação", "SecondaryActivity.4": "63.99-2-00 - Outras atividades de prestação de serviços de informação não especificadas anteriormente", "Phone.0": "2130304676", "Address.Core.0": "AV DAS AMERICAS", "Address.City.0": "RIO DE JANEIRO", "Address.Complement.0": "BLC 2 SAL 129", "Address.Neighborhood.0": "BARRA DA TIJUCA", "Address.Number.0": "00700", "Address.State.0": "RJ", "Address.ZipCode.0": "22.****100" }, "QueryDate": "2025-08-25T00:00:00" } ], "outcome": "clear" }, "simulated": false, "costMinor": 50 } ], "totalCostMinor": 50 } ``` ```json 422 theme={null} { "error": { "code": "validation_failed", "message": "Alguns serviços não podem ser executados. Nada foi consultado nem cobrado.", "correlationId": "4f1c9a7e-2b1d-4c55-9a51-0d2f6f1c2a10", "details": { "results": [ { "service": "SERVICE_RFB_PJ_ON_DEMAND", "status": { "code": 422, "message": "Validation failed" }, "result": null, "errors": [ { "field": "cnpj", "code": "required", "message": "Informe CNPJ: este serviço exige o campo." } ] } ] } } } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.