# CNPJ.ws - [Visão Geral](/): A API do CNPJ.ws fornece dados de empresas brasileiras a partir do CNPJ, com informações da Receita Federal, SEFAZ, Sintegra e Suframa organizadas em uma API REST rápida. - Modelos de Dados - [Modelos de Dados](/modelos-de-dados): Documentação dos modelos de dados retornados pelas APIs do CNPJ.ws, com os campos e descrições de empresas, estabelecimentos, sócios, atividades econômicas e mais. - [Atividades Econômicas](/modelos-de-dados/atividades-economicas): Modelo de dados das atividades econômicas (CNAE) retornadas pela API do CNPJ.ws, com códigos e descrições. - [Cidades](/modelos-de-dados/cidades): Modelo de dados das cidades retornadas pela API do CNPJ.ws, incluindo os códigos do IBGE. - [Estabelecimentos](/modelos-de-dados/estabelecimentos): Modelo de dados dos estabelecimentos retornados pela API do CNPJ.ws, com os campos de cada filial ou matriz da empresa. - [Estados](/modelos-de-dados/estados): Modelo de dados dos estados retornados pela API do CNPJ.ws, com nome, sigla e código do IBGE. - [Inscrições Estaduais](/modelos-de-dados/inscricoes-estaduais): Modelo de dados das inscrições estaduais retornadas pela API do CNPJ.ws, com número, situação e estado. - [Mensagens de Erro](/modelos-de-dados/mensagens-erro): Lista dos códigos e mensagens de erro que a API do CNPJ.ws pode retornar. - [Naturezas Jurídicas](/modelos-de-dados/naturezas): Modelo de dados das naturezas jurídicas retornadas pela API do CNPJ.ws, com código e descrição. - [Países](/modelos-de-dados/paises): Modelo de dados dos países retornados pela API do CNPJ.ws. - [Portes](/modelos-de-dados/portes): Modelo de dados do porte da empresa retornado pela API do CNPJ.ws. - [Qualificações Societárias](/modelos-de-dados/qualificacoes): Modelo de dados das qualificações societárias retornadas pela API do CNPJ.ws. - [Regimes Tributários](/modelos-de-dados/regimes-tributarios): Modelo de dados dos regimes tributários (extraídos da ECF) retornados pela API do CNPJ.ws, disponíveis a partir de 2021. - [Simples Nacional e MEI](/modelos-de-dados/simples-nacional): Modelo de dados do Simples Nacional e do MEI retornados pela API do CNPJ.ws. - [Situações Cadastrais](/modelos-de-dados/situacoes-cadastrais): Modelo de dados das situações cadastrais retornadas pela API do CNPJ.ws. - [Sócios](/modelos-de-dados/socios): Modelo de dados dos sócios (quadro societário) retornados pela API do CNPJ.ws. - [Suframa](/modelos-de-dados/inscricoes-suframa): Modelo de dados das inscrições no Suframa retornadas pela API do CNPJ.ws. - [Changelog](/changelog): Histórico de alterações da API do CNPJ.ws, seguindo o formato Keep a Changelog e o versionamento semântico. - **Referência de API** - API - Comercial - [API Comercial](/referencia-de-api/api-comercial): Documentação da API Comercial do CNPJ.ws: consulta de CNPJ, consulta pela raiz do CNPJ, consumo de requisições e validação de inscrição no Suframa. - [Consultando CNPJ na API Comercial](/referencia-de-api/api-comercial/consultando-cnpj): Como consultar um CNPJ diretamente na API Comercial do CNPJ.ws, autenticando com o header x_api_token. - [Consultando pela Raiz do CNPJ](/referencia-de-api/api-comercial/consultando-raiz-cnpj): Como consultar todos os estabelecimentos de uma empresa pela raiz do CNPJ (8 primeiros dígitos) na API Comercial do CNPJ.ws. - [Pesquisa de Empresas](/referencia-de-api/api-comercial/pesquisa-de-empresas): Como pesquisar empresas por filtros na API Comercial do CNPJ.ws (Plano Premium), com paginação baseada em cursor. - [Consultando o Consumo de Requisições Mensais](/referencia-de-api/api-comercial/consultando-consumo): Como consultar a quantidade de requisições mensais realizadas na API Comercial do CNPJ.ws. - [Validando Inscrição no Suframa](/referencia-de-api/api-comercial/validando-inscricao-suframa): Como validar uma inscrição no Suframa por CNPJ na API Comercial do CNPJ.ws usando o método POST. - API - Pública - [API Pública](/referencia-de-api/api-publica): Documentação da API Pública do CNPJ.ws: consulta de CNPJ, validação de inscrição no Suframa e limitações de uso. - [Consultando CNPJ na API Pública](/referencia-de-api/api-publica/consultando-cnpj): Como consultar um CNPJ na API Pública do CNPJ.ws, com até 3 requisições por minuto pelo método GET. - [Validando Inscrição no Suframa na API Pública](/referencia-de-api/api-publica/validando-inscricao-suframa): Como validar uma inscrição no Suframa na API Pública do CNPJ.ws, com até 3 requisições por minuto. - [Limitações](/referencia-de-api/api-publica/limitacoes): Limitações de uso da API Pública do CNPJ.ws: 3 requisições por minuto por IP e o erro HTTP 429. - **BLOG** - Blog - [O que é o CNPJ](/blog/o-que-e-cnpj): O Cadastro Nacional de Pessoa Jurídica é o registro utilizado pela Receita Federal para a abertura de uma instituição com ou sem fins lucrativos - [Como automatizar o cadastro de clientes com uma API de consulta CNPJ](/blog/como-automatizar-o-cadastro-de-clientes-com-uma-api-de-consulta-cnpj): Elimine a digitação manual no cadastro de pessoas jurídicas usando uma API de consulta CNPJ para preencher razão social, endereço, CNAE e regime tributário automaticamente. - [CNPJ Alfanumérico](/blog/cnpj-alfanumerico): Como calcular os dígitos verificadores do CNPJ alfanumérico - [CNPJ Alfanumérico de Teste](/blog/cnpj-alfanumerico-de-teste): A API do CNPJ.ws já está preparada. Adapte sua aplicação com calma usando esse exemplo e você estará pronto quando as primeiras inscrições alfanuméricas começarem a ser emitidas, em julho de 2026. - [Consultar CNPJ Gratuitamente com Java](/blog/consultar-cnpj-java): Veja como consultar dados de empresas pelo CNPJ utilizando a API do CNPJ.ws, com dados da Receita Federal, Sintegra e Suframa usando o Java. - [Consultar CNPJ Gratuitamente com Excel](/blog/consultar-cnpj-excel): Use essa planilha de excel para consultar dados de empresas através do CNPJ utilizando a API do CNPJ.ws, com dados da Receita Federal, Sintegra e Suframa. - [Consultar CNPJ com PHP](/blog/consulta-cnpj-php): Veja como consultar dados de empresas pelo CNPJ utilizando a API do CNPJ.ws, com dados da Receita Federal, Sintegra e Suframa usando o PHP. - [Gatilho para consultar CNPJ no Protheus](/blog/gatilho-consultar-cnpj): Gatilho para consultar CNPJ no cadastro de clientes ou fornecedores no Protheus em ADVPL utilizando a API do CNPJ.ws com dados da Receita Federal, Sintegra e Suframa. - [Manter o cadastro de clientes e fornecedores atualizados](/blog/manter-clientes-fornecedores-atualizados): Saiba como manter o cadastro de clientes e fornecedores sempre atualizado usando a API do CNPJ.ws com dados de órgãos públicos. - [Consultar CNPJ com Javascript e Node.JS](/blog/consultar-cnpj-javascript): Veja como consultar dados de empresas pelo CNPJ utilizando a API do CNPJ.ws, com dados da Receita Federal, Sintegra e Suframa usando o Javascrpit/Node.js - [Consultar CNPJ com ADVPL (Protheus)](/blog/integracao-protheus): Consultar CNPJ no Protheus utilizadando a API do CNPJ.ws com ADVPL - [Projeto CNPJ.ws](/blog/cnpjws): Conheça o projeto CNPJ.ws, uma API rápida e gratuita com dados públicos de empresas brasileiras, subproduto da plataforma Bitize. # CNPJ.ws - [Overview](/en): The CNPJ.ws API provides data on Brazilian companies from the CNPJ, with information from Receita Federal, SEFAZ, Sintegra and Suframa organized in a fast REST API. - Data Models - [Data Models](/en/modelos-de-dados): Documentation of the data models returned by the CNPJ.ws APIs, with the fields and descriptions of companies, establishments, partners, economic activities and more. - [Countries](/en/modelos-de-dados/paises): Data model of the countries returned by the CNPJ.ws API. - [States](/en/modelos-de-dados/estados): Data model of the states returned by the CNPJ.ws API, with name, abbreviation and IBGE code. - [Cities](/en/modelos-de-dados/cidades): Data model of the cities returned by the CNPJ.ws API, including the IBGE codes. - [Legal Natures](/en/modelos-de-dados/naturezas): Data model of the legal natures returned by the CNPJ.ws API, with code and description. - [Company Sizes](/en/modelos-de-dados/portes): Data model of the company size returned by the CNPJ.ws API. - [Economic Activities](/en/modelos-de-dados/atividades-economicas): Data model of the economic activities (CNAE) returned by the CNPJ.ws API, with codes and descriptions. - [Corporate Qualifications](/en/modelos-de-dados/qualificacoes): Data model of the corporate qualifications returned by the CNPJ.ws API. - [Partners](/en/modelos-de-dados/socios): Data model of the partners (ownership structure) returned by the CNPJ.ws API. - [Simples Nacional and MEI](/en/modelos-de-dados/simples-nacional): Data model of Simples Nacional and MEI returned by the CNPJ.ws API. - [Establishments](/en/modelos-de-dados/estabelecimentos): Data model of the establishments returned by the CNPJ.ws API, with the fields of each branch or headquarters of the company. - [State Registrations](/en/modelos-de-dados/inscricoes-estaduais): Data model of the state registrations returned by the CNPJ.ws API, with number, status and state. - [Suframa](/en/modelos-de-dados/inscricoes-suframa): Data model of the Suframa registrations returned by the CNPJ.ws API. - [Tax Regimes](/en/modelos-de-dados/regimes-tributarios): Data model of the tax regimes (extracted from the ECF) returned by the CNPJ.ws API, available from 2021 onward. - [Registration Statuses](/en/modelos-de-dados/situacoes-cadastrais): Data model of the registration statuses returned by the CNPJ.ws API. - [Error Messages](/en/modelos-de-dados/mensagens-erro): List of the error codes and messages that the CNPJ.ws API can return. - [Changelog](/en/changelog): Change history of the CNPJ.ws API, following the Keep a Changelog format and semantic versioning. - **API Reference** - API - Commercial - [API - Commercial](/en/referencia-de-api/api-comercial): Documentation of the CNPJ.ws Commercial API: CNPJ query, query by CNPJ root, request consumption and Suframa registration validation. - [Consulting CNPJ in the Commercial API](/en/referencia-de-api/api-comercial/consultando-cnpj): How to query a CNPJ directly in the CNPJ.ws Commercial API, authenticating with the x_api_token header. - [Consulting by CNPJ Root](/en/referencia-de-api/api-comercial/consultando-raiz-cnpj): How to query all establishments of a company by the CNPJ root (first 8 digits) in the CNPJ.ws Commercial API. - [Company Search](/en/referencia-de-api/api-comercial/pesquisa-de-empresas): How to search companies by filters in the CNPJ.ws Commercial API (Premium Plan), with cursor-based pagination. - [Consulting Monthly Request Consumption](/en/referencia-de-api/api-comercial/consultando-consumo): How to check the number of monthly requests made in the CNPJ.ws Commercial API. - [Validating Suframa Registration](/en/referencia-de-api/api-comercial/validando-inscricao-suframa): How to validate a Suframa registration by CNPJ in the CNPJ.ws Commercial API using the POST method. - API - Public - [API - Public](/en/referencia-de-api/api-publica): Documentation of the CNPJ.ws Public API: CNPJ query, Suframa registration validation and usage limits. - [Consulting CNPJ in the Public API](/en/referencia-de-api/api-publica/consultando-cnpj): How to query a CNPJ in the CNPJ.ws Public API, with up to 3 requests per minute using the GET method. - [Validating Suframa Registration in the Public API](/en/referencia-de-api/api-publica/validando-inscricao-suframa): How to validate a Suframa registration in the CNPJ.ws Public API, with up to 3 requests per minute. - [Limitations](/en/referencia-de-api/api-publica/limitacoes): Usage limits of the CNPJ.ws Public API: 3 requests per minute per IP and the HTTP 429 error. - **BLOG** - Blog - [What is CNPJ](/en/blog/o-que-e-cnpj): The National Register of Legal Entities is the registration used by the Federal Revenue to open an institution with or without profit purposes - [How to automate customer registration with a CNPJ lookup API](/en/blog/how-to-automate-customer-registration-with-a-cnpj-api): Eliminate manual data entry when registering companies by using a CNPJ lookup API to fill in legal name, address, economic activity and tax regime automatically. - [Alphanumeric CNPJ](/en/blog/alphanumeric-cnpj): How to calculate the check digits of an alphanumeric CNPJ (Brazilian company registration number) - [Alphanumeric CNPJ Test Example](/en/blog/alphanumeric-cnpj-test-example): The CNPJ.ws API is already prepared. Adapt your application calmly using this example and you'll be ready when the first alphanumeric registrations start being issued, in July 2026. - [Consult CNPJ for Free with Java](/en/blog/consultar-cnpj-java): Learn how to consult company data through the CNPJ using the CNPJ.ws API, with data from Receita Federal, Sintegra, and Suframa using Java. - [Consult CNPJ for Free with Excel](/en/blog/consultar-cnpj-excel): Use this Excel spreadsheet to consult company data through the CNPJ using the CNPJ.ws API, with data from Receita Federal, Sintegra, and Suframa. - [Consult CNPJ with PHP](/en/blog/consulta-cnpj-php): Learn how to consult company data through the CNPJ using the CNPJ.ws API, with data from Receita Federal, Sintegra, and Suframa using PHP. - [Trigger to Consult CNPJ in Protheus](/en/blog/gatilho-consultar-cnpj): Trigger to consult CNPJ in the registration of customers or suppliers in Protheus using ADVPL and the CNPJ.ws API with data from Receita Federal, Sintegra, and Suframa. - [Keep Customer and Supplier Records Updated](/en/blog/manter-clientes-fornecedores-atualizados): Learn how to keep your customer and supplier records always up to date using the CNPJ.ws API with data from public agencies. - [Consult CNPJ with Javascript and Node.JS](/en/blog/consultar-cnpj-javascript): Learn how to consult company data through the CNPJ using the CNPJ.ws API, with data from Receita Federal, Sintegra, and Suframa using Javascript/Node.js - [Consult CNPJ with ADVPL (Protheus)](/en/blog/integracao-protheus): Consult CNPJ in Protheus using the CNPJ.ws API with ADVPL - [CNPJ.ws Project](/en/blog/cnpjws): Learn about the CNPJ.ws project, a fast and free API with public data on Brazilian companies, a spin-off of the Bitize platform. # CNPJ.ws - [Visión General](/es): La API de CNPJ.ws proporciona datos de empresas brasileñas a partir del CNPJ, con información de Receita Federal, SEFAZ, Sintegra y Suframa organizada en una API REST rápida. - Modelos de datos - [Modelos de datos](/es/modelos-de-dados): Documentación de los modelos de datos devueltos por las APIs de CNPJ.ws, con los campos y descripciones de empresas, establecimientos, socios, actividades económicas y más. - [Países](/es/modelos-de-dados/paises): Modelo de datos de los países devueltos por la API de CNPJ.ws. - [Estados](/es/modelos-de-dados/estados): Modelo de datos de los estados devueltos por la API de CNPJ.ws, con nombre, sigla y código del IBGE. - [Ciudades](/es/modelos-de-dados/cidades): Modelo de datos de las ciudades devueltas por la API de CNPJ.ws, incluyendo los códigos del IBGE. - [Naturalezas Jurídicas](/es/modelos-de-dados/naturezas): Modelo de datos de las naturalezas jurídicas devueltas por la API de CNPJ.ws, con código y descripción. - [Tamaños](/es/modelos-de-dados/portes): Modelo de datos del tamaño de la empresa devuelto por la API de CNPJ.ws. - [Actividades Económicas](/es/modelos-de-dados/atividades-economicas): Modelo de datos de las actividades económicas (CNAE) devueltas por la API de CNPJ.ws, con códigos y descripciones. - [Calificaciones Societarias](/es/modelos-de-dados/qualificacoes): Modelo de datos de las calificaciones societarias devueltas por la API de CNPJ.ws. - [Socios](/es/modelos-de-dados/socios): Modelo de datos de los socios (cuadro societario) devueltos por la API de CNPJ.ws. - [Simples Nacional y MEI](/es/modelos-de-dados/simples-nacional): Modelo de datos del Simples Nacional y del MEI devueltos por la API de CNPJ.ws. - [Establecimientos](/es/modelos-de-dados/estabelecimentos): Modelo de datos de los establecimientos devueltos por la API de CNPJ.ws, con los campos de cada sucursal o matriz de la empresa. - [Inscripciones Estatales](/es/modelos-de-dados/inscricoes-estaduais): Modelo de datos de las inscripciones estatales devueltas por la API de CNPJ.ws, con número, situación y estado. - [Suframa](/es/modelos-de-dados/inscricoes-suframa): Modelo de datos de las inscripciones en Suframa devueltas por la API de CNPJ.ws. - [Regímenes Tributarios](/es/modelos-de-dados/regimes-tributarios): Modelo de datos de los regímenes tributarios (extraídos de la ECF) devueltos por la API de CNPJ.ws, disponibles a partir de 2021. - [Situaciones Cadastrales](/es/modelos-de-dados/situacoes-cadastrais): Modelo de datos de las situaciones cadastrales devueltas por la API de CNPJ.ws. - [Mensajes de Error](/es/modelos-de-dados/mensagens-erro): Lista de los códigos y mensajes de error que la API de CNPJ.ws puede devolver. - [Registro de cambios](/es/changelog): Historial de cambios de la API de CNPJ.ws, siguiendo el formato Keep a Changelog y el versionado semántico. - **Referencia de API** - API - Comercial - [API - Comercial](/es/referencia-de-api/api-comercial): Documentación de la API Comercial de CNPJ.ws: consulta de CNPJ, consulta por la raíz del CNPJ, consumo de solicitudes y validación de inscripción en Suframa. - [Consultando CNPJ en la API Comercial](/es/referencia-de-api/api-comercial/consultando-cnpj): Cómo consultar un CNPJ directamente en la API Comercial de CNPJ.ws, autenticando con el header x_api_token. - [Consultando por la Raíz del CNPJ](/es/referencia-de-api/api-comercial/consultando-raiz-cnpj): Cómo consultar todos los establecimientos de una empresa por la raíz del CNPJ (los 8 primeros dígitos) en la API Comercial de CNPJ.ws. - [Búsqueda de Empresas](/es/referencia-de-api/api-comercial/pesquisa-de-empresas): Cómo buscar empresas por filtros en la API Comercial de CNPJ.ws (Plan Premium), con paginación basada en cursor. - [Consultando el Consumo de Solicitudes Mensuales](/es/referencia-de-api/api-comercial/consultando-consumo): Cómo consultar la cantidad de solicitudes mensuales realizadas en la API Comercial de CNPJ.ws. - [Validando Inscripción en Suframa](/es/referencia-de-api/api-comercial/validando-inscricao-suframa): Cómo validar una inscripción en Suframa por CNPJ en la API Comercial de CNPJ.ws usando el método POST. - API - Pública - [API - Pública](/es/referencia-de-api/api-publica): Documentación de la API Pública de CNPJ.ws: consulta de CNPJ, validación de inscripción en Suframa y limitaciones de uso. - [Consultando CNPJ en la API Pública](/es/referencia-de-api/api-publica/consultando-cnpj): Cómo consultar un CNPJ en la API Pública de CNPJ.ws, con hasta 3 solicitudes por minuto mediante el método GET. - [Validando Inscripción en Suframa en la API Pública](/es/referencia-de-api/api-publica/validando-inscricao-suframa): Cómo validar una inscripción en Suframa en la API Pública de CNPJ.ws, con hasta 3 solicitudes por minuto. - [Limitaciones](/es/referencia-de-api/api-publica/limitacoes): Limitaciones de uso de la API Pública de CNPJ.ws: 3 solicitudes por minuto por IP y el error HTTP 429. - **BLOG** - Blog - [Qué es el CNPJ](/es/blog/o-que-e-cnpj): El Cadastro Nacional de Pessoa Jurídica es el registro utilizado por la Receita Federal para la apertura de una institución con o sin fines de lucro. - [Cómo automatizar el registro de clientes con una API de consulta CNPJ](/es/blog/como-automatizar-el-registro-de-clientes-con-una-api-de-consulta-cnpj): Elimine la digitación manual en el registro de personas jurídicas usando una API de consulta CNPJ para completar razón social, dirección, CNAE y régimen tributario automáticamente. - [CNPJ Alfanumérico](/es/blog/cnpj-alfanumerico): Cómo calcular los dígitos de control de un CNPJ alfanumérico. - [CNPJ Alfanumérico de Prueba](/es/blog/cnpj-alfanumerico-de-prueba): La API de CNPJ.ws ya está preparada. Adapta tu aplicación con calma usando este ejemplo y estarás listo cuando las primeras inscripciones alfanuméricas comiencen a emitirse, en julio de 2026. - [Consultar CNPJ Gratuitamente con Java](/es/blog/consultar-cnpj-java): Vea cómo consultar datos de empresas por el CNPJ utilizando la API de CNPJ.ws, con datos de la Receita Federal, Sintegra y Suframa usando Java. - [Consultar CNPJ Gratuitamente con Excel](/es/blog/consultar-cnpj-excel): Use esta hoja de cálculo de Excel para consultar datos de empresas a través del CNPJ utilizando la API de CNPJ.ws, con datos de la Receita Federal, Sintegra y Suframa. - [Consultar CNPJ con PHP](/es/blog/consulta-cnpj-php): Vea cómo consultar datos de empresas por el CNPJ utilizando la API de CNPJ.ws, con datos de la Receita Federal, Sintegra y Suframa usando PHP. - [Gatilho para consultar CNPJ en Protheus](/es/blog/gatilho-consultar-cnpj): Gatilho para consultar CNPJ en el registro de clientes o proveedores en Protheus en ADVPL utilizando la API de CNPJ.ws con datos de la Receita Federal, Sintegra y Suframa. - [Mantener el registro de clientes y proveedores actualizado](/es/blog/manter-clientes-fornecedores-atualizados): Aprenda a mantener el registro de clientes y proveedores siempre actualizado usando la API de CNPJ.ws con datos de organismos públicos. - [Consultar CNPJ con Javascript y Node.JS](/es/blog/consultar-cnpj-javascript): Vea cómo consultar datos de empresas por el CNPJ utilizando la API de CNPJ.ws, con datos de la Receita Federal, Sintegra y Suframa usando Javascript/Node.js - [Consultar CNPJ con ADVPL (Protheus)](/es/blog/integracao-protheus): Consultar CNPJ en Protheus utilizando la API de CNPJ.ws con ADVPL - [Proyecto CNPJ.ws](/es/blog/cnpjws): Conozca el proyecto CNPJ.ws, una API rápida y gratuita con datos públicos de empresas brasileñas, derivada de la plataforma Bitize.