"description":"Serviço de Consultas On-line, que consiste em prover acesso aos dados não protegidos por sigilo fiscal constantes de base de dados da Secretaria da Receita Federal do Brasil (RFB), para órgãos e entidades da Administração Pública Federal direta, autárquica e fundacional nos termos da Portaria RFB nº 1384, de 09 de setembro de 2016.\n___ \n\n# Endpoints\nA API Consulta CNPJ disponibiliza três serviços, correspondentes a três tipos de consultas, que se diferenciam pelo número de campos retornados.\n### Endpoints de Produção\n\n* Consulta Básica [https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-basica/v2/basica/](https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-basica/v2/basica/)\n\n* Consulta CNPJ-QSA - Quadro de Sócios e Administradores [https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-qsa/v2/qsa/](https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-qsa/v2/qsa/)\n\n* Consulta CNPJ-Empresa - Informações detalhadas sobre a empresa [https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-empresa/v2/empresa/](https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-empresa/v2/empresa/)\n\n### Endpoints de Homologação (Sandbox)\n* Consulta Básica [https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-basica/v2/basica/](https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-basica/v2/basica/)\n\n* Consulta CNPJ-QSA - Quadro de Sócios e Administradores [https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-qsa/v2/qsa/](https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-qsa/v2/qsa/)\n\n* Consulta CNPJ-Empresa - Informações detalhadas sobre a empresa [https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-empresa/v2/empresa/](https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-empresa/v2/empresa/)\n<br>\n#### Endpoints Access Token\n* Endpoint Access Token URL de Produção: [https://apigateway.conectagov.estaleiro.serpro.gov.br/oauth2/jwt-token](https://apigateway.conectagov.estaleiro.serpro.gov.br/oauth2/jwt-token) \n\n* Endpoint Access Token URL de Homologação: [https://h-apigateway.conectagov.estaleiro.serpro.gov.br/oauth2/jwt-token](https://h-apigateway.conectagov.estaleiro.serpro.gov.br/oauth2/jwt-token)\n___\n# Retorno\n\n ## Campos\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| ni | string | Número de Inscrição da Pessoa Jurídica, no formato 99999999999999 | x | x | x |\n| tipoEstabelecimento | string | Tipo de estabelecimento da Pessoa Jurídica: 1: Matriz, 2: Filial | x | x | x |\n| nomeEmpresarial | string | Nome empresarial da Pessoa Jurídica | x | x | x |\n| nomefantasia | string | Nome fantasia da Pessoa Jurídica | x | x | x |\n| situacaoCadastral(1) | estrutura | Situação Cadastral da Pessoa Jurídica| x | x | x |\n| naturezaJuridica(2) | estrutura | Informação da Natureza Jurídica da Pessoa Jurídica | x | x | x |\n| dataAbertura | string | AAAAMMDD - Data de abertura do estabelcimento consultado. | x | x | x |\n| cnaePrincipal(3) | estrutura | Informação da Classificação Nacional de Atividades Econômicas. | x | x | x |\n| cnaeSecundarias(4) | estrutura | Informação da Classificação Nacional de Atividades Econômicas : - Várias ocorrências| x | x | x |\n| endereco(5) | estrutura | Endereço da Pessoa Jurídica | x | x | x |\n| municipioJurisdicao(6) | estrutura | Município de Jurisdição do endereço | x | x | x |\n| telefone(7) | estrutura | Números de telefone da Pessoa Jurídica - Várias ocorrências | x | x | x |\n| correioEletronico | string | Correio eletrônico da Pessoa Jurídica | x | x | x |\n| capitalSocial | string | O capital social da Pessoa Jurídica é um valor retornado sem formatação, porém os 2 últimos dígitos a direita são referentes aos centavos. o valor retornado deve ser dividido por 100 para obter o valor real | x | x | x |\n| porteEmpresa | string | Porte da Pessoa Jurídica: 01: MicroEmpresa-ME, 03: Empresas de pequeno porte EPP, 05: Demais empresas | x | x | x |\n| situacaoEspecial | string | Tipos de Situação Especial da Pessoa Jurídica: Início de Concordata, Término de Concordata, Em Liquidação, Em Liquidação Extra-Judicial, Falido, Intervenção, Financeiro e de Capitais, Liquidação Judicial, Liquidação Extra-Judicial, Recuperação Judicial | x | x | x |\n| dataSituacaoEspecial | string | Data em que a empresa entrou na Situação Especial | x | x | x |\n| informacoesAdicionais(8) | estrutura | Informações Referentes a MEI e optante pelo SIMPLES | | x | x |\n| listaPeriodosSimples(9) | estrutura | Períodos em que a empresa optou pelo SIMPLES - Várias ocorrências | | x | x |\n| socios(10) | estrutura | Sócios da Pessoa Jurídica - Várias ocorrências | | x | x |\n\n ## situacaoCadastral(1)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| codigo | string | Código da situação cadastral: 1: Nula, 2: Ativa, 3: Suspensa, 4: Inapta, 8: Baixada | x | x | x |\n| data | string | Data da situação | x | x | x |\n| motivo | string | Descrição da situação cadastral | x | x | x | \n\n ## naturezaJuridica(2)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| codigo | string | Código da situação cadastral | x | x | x |\n| descricao | string | Descrição da Natureza Jurídica | x | x | x | \n\n ## cnaePrincipal(3)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| codigo | string | Código do CNAE | x | x | x |\n| descricao | string | Descrição do CNAE | x | x | x | \n\n ## cnaeSecundarias(4)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| codigo | string | Código do CNAE | x | x | x |\n| descricao | string | Descrição do CNAE | x | x | x | \n\n ## endereco(5)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| tipoLogradouro | string | Rua, Quadra, etc.. | x | x | x |\n| logradouro | string | Localidade | x | x | x |\n| numero | string | Número do lote ou área | x | x | x |\n| complemento | string | Complemento de endereço | x | x | x |\n| cep | string | Código de endereçamento postal da localidade | x | x | x |\n| bairro | string | Setor da localidade | x | x | x |\n| municipio(12) | estrutura | Divisão administrativa do endereço | x | x | x |\n| uf | string | Unidade da Federação | x | x | x |\n| pais(13) | estrutura | País do endereço | x | x | x | \n\n ## municipioJurisdicao(6)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| codigo | string | Código do município | x | x | x |\n| descricao | string | Nome do Município | x | x | x | \n\n ## telefone(7)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| ddd | string | Código do DDD | x | x | x |\n| numero | string | Número do telefone | x | x | x | \n\n ## informacoesAdicionais(8)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| optanteSimples | string | Indicador de optante do Simples | | x | x |\n| optanteMei | string | Indicador de optante do MEI | | x | x | \n\n ## listaPeriodoSimples(9)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| dataInicio | string | Indicador de optante do Simples | | x | x |\n| dataFim | string | Data de término da Opção pelo SIMPLES | | x | x | \n\n ## socios(10)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| tipoSocio | string | Tipo de Sócio: 1:Pessoa Jurídica, 2:Pessoa Física, 3:Sócio Estrangeiro | | x | x |\n| cpf | string | Cpf do Sócio | | | x |\n| nome | string | Nome do Sócio | | x | x |\n| qualificacao | string | Tipos da Qualificação do Sócio: 05: Administrador, 08: Conselheiro de Administração, 10: Diretor, 16: Presidente, 17: Procurador, 18: Secretário, 20: Sociedade Consorciada, 21: Sociedade Filiada, 22: Sócio, 23: Sócio Capitalista, 24: Sócio Comanditado, 25: Sócio Comanditário, 26: Sócio de Indústria, 28: Sócio-Gerente, 29: Sócio Incapaz ou Relat.Incapaz (exceto menor), 30: Sócio Menor (Assistido/Representado), 31: Sócio Ostensivo, 33: Tesoureiro, 37: Sócio Pessoa Jurídica Domiciliado no Exterior, 38: Sócio Pessoa Física Residente ou Domiciliado no Exterior, 47: Sócio Pessoa Física Residente no Brasil, 48: Sócio Pessoa Jurídica Domiciliado no Brasil, 49: Sócio-Administrador, 52: Sócio com Capital, 53: Sócio sem Capital, 54: Fundador, 55: Sócio Comanditado Residente no Exterior, 56: Sócio Comanditário Pessoa Física Residente no Exterior, 57: Sócio Comanditário Pessoa Jurídica Domiciliado no Exterior, 58: Sócio Comanditário Incapaz, 59: Produtor Rural, 63: Cotas em Tesouraria, 65: Titular Pessoa Física Residente ou Domiciliado no Brasil, 66: Titular Pessoa Física Residente ou Domiciliado no Exterior, 67: Titular Pessoa Física Incapaz ou Relativamente Incapaz (exceto menor), 68: Titular Pessoa Física Menor (Assistido/Representado), 70: Administrador Residente ou Domiciliado no Exterior, 71: Conselheiro de Administração Residente ou Domiciliado no Exterior, 72: Diretor Residente ou Domiciliado no Exterior, 73: Presidente Residente ou Domiciliado no Exterior, 74: Sócio-Administrador Residente ou Domiciliado no Exterior, 75: Fundador Residente ou Domiciliado no Exterior, 76: Protetor, 77: Vice-Presidente, 78: Titular Pessoa Jurídica Domiciliada no Brasil, 79: Titular Pessoa Jurídica Domiciliada no Exterior | | x | x |\n| dataInclusao | string | Data de inclusão na sociedade| | | x |\n| representanteLegal(11) | estrutura | representante legal do Sócio | | x | x | \n| pais(13) | estrutura | País de residência do Sócio | | x | x | \n\n ## representante legal(11)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| cpf | string | CPF do Representante Legal | | | x |\n| nome | string |Nome do Representante Legal | | x | x | \n| qualificacao | string |Qualificação do Representante Legal: 05: Administrador, 09: Curador, 14: Mãe, 15: Pai, 17: Procurador, 35: Tutor | | x | x | \n\n ## municipio(12)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| codigo | string | Código do município | x | x | x |\n| descricao | string | Nome do município | x | x | x | \n\n ## pais(13)\n\n| Nome | Tipo | Conteúdo | Básica | Qsa | Empresa |\n| - | - | - | - | - | - |\n| codigo | string | Código do País | x | x | x |\n| descricao | string | Nome do País | x | x | x | \n\n## Observação\n Quando o CNPJ consultado tiver o campo codigo referente ao grupo naturezaJuridica igual a 213-5 cuja \n descrição é Empresário (Individual) a API Consulta CNPJ não retornará os campos referentes \n ao grupo socios: tipoSocio, cpf, nome, qualificacao, dataInclusao, pais(codigo e descrição), \n representanteLegal (cpf, nome, qualificação).",
"summary":"Consulta os dados de um CNPJ(Empresa)",
"description":"Consulta CNPJ-Empresa",
"parameters":[
{
"name":"x-cpf-usuario",
"in":"header",
"description":"CPF do usuário da requisição",
"required":true,
"schema":{
"type":"string",
"default":"CPF do usuário da requisição"
}
},
{
"name":"CNPJempresa",
"in":"path",
"required":true,
"schema":{
"type":"string"
}
}
],
"responses":{
"200":{
"description":"OK - Tudo funcionou como esperado e a validação dos dados foi realizada com sucesso",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/CNPJempresa"
}
}
}
},
"400":{
"description":"Requisição inválida - O número de CNPJ informado não é válido.",
"content":{}
},
"401":{
"description":"Não autorizado - Problemas durante a autenticação.",
"content":{}
},
"403":{
"description":"Proibido - Este erro ocorre quando há algum caminho errado na requisição. Certifique-se de chamar a API conforme orientação na demonstração da versão que estiver utilizando.",
"content":{}
},
"404":{
"description":"Não Encontrado - Não existe CNPJ com o número de inscrição informado.",
"content":{}
},
"500":{
"description":"Erro no servidor - Ocorreu algum erro interno no Servidor.",
"content":{}
},
"502":{
"description":"Ocorreu algum erro de integração que impossibilitou que esta requisição de consulta da API obtivesse os dados solicitados.",
"content":{}
},
"504":{
"description":"Tempo Esgotado do Gateway - Ocorreu algum erro de rede e o gateway não respondeu a tempo. A requisição não chegou até a API Consulta CNPJ.",
"content":{}
}
}
}
},
"/api-cnpj-qsa/v2/qsa/{CNPJqsa}":{
"get":{
"tags":[
"cnpj"
],
"summary":"Consulta os dados de um CNPJ(QSA)",
"description":"Consulta CNPJ-QSA",
"parameters":[
{
"name":"x-cpf-usuario",
"in":"header",
"description":"CPF do usuário da requisição",
"required":true,
"schema":{
"type":"string",
"default":"CPF do usuário da requisição"
}
},
{
"name":"CNPJqsa",
"in":"path",
"required":true,
"schema":{
"type":"string"
}
}
],
"responses":{
"200":{
"description":"OK - Tudo funcionou como esperado e a validação dos dados foi realizada com sucesso",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/CNPJqsa"
}
}
}
},
"400":{
"description":"Requisição inválida - O número de CNPJ informado não é válido.",
"content":{}
},
"401":{
"description":"Não autorizado - Problemas durante a autenticação.",
"content":{}
},
"403":{
"description":"Proibido - Este erro ocorre quando há algum caminho errado na requisição. Certifique-se de chamar a API conforme orientação na demonstração da versão que estiver utilizando.",
"content":{}
},
"404":{
"description":"Não Encontrado - Não existe CNPJ com o número de inscrição informado.",
"content":{}
},
"500":{
"description":"Erro no servidor - Ocorreu algum erro interno no Servidor.",
"content":{}
},
"502":{
"description":"Ocorreu algum erro de integração que impossibilitou que esta requisição de consulta da API obtivesse os dados solicitados.",
"content":{}
},
"504":{
"description":"Tempo Esgotado do Gateway - Ocorreu algum erro de rede e o gateway não respondeu a tempo. A requisição não chegou até a API Consulta CNPJ.",
"content":{}
}
}
}
},
"/api-cnpj-basica/v2/basica/{CNPJbasica}":{
"get":{
"tags":[
"cnpj"
],
"summary":"Consulta os dados de um CNPJ(Básica)",
"description":"Consulta CNPJ-Básica",
"parameters":[
{
"name":"x-cpf-usuario",
"in":"header",
"description":"CPF do usuário da requisição",
"required":true,
"schema":{
"type":"string",
"default":"CPF do usuário da requisição"
}
},
{
"name":"CNPJbasica",
"in":"path",
"required":true,
"schema":{
"type":"string"
}
}
],
"responses":{
"200":{
"description":"OK - Tudo funcionou como esperado e a validação dos dados foi realizada com sucesso",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/CNPJbasica"
}
}
}
},
"400":{
"description":"Requisição inválida - O número de CNPJ informado não é válido.",
"content":{}
},
"401":{
"description":"Não autorizado - Problemas durante a autenticação.",
"content":{}
},
"403":{
"description":"Proibido - Este erro ocorre quando há algum caminho errado na requisição. Certifique-se de chamar a API conforme orientação na demonstração da versão que estiver utilizando.",
"content":{}
},
"404":{
"description":"Não Encontrado - Não existe CNPJ com o número de inscrição informado.",
"content":{}
},
"500":{
"description":"Erro no servidor - Ocorreu algum erro interno no Servidor.",
"content":{}
},
"502":{
"description":"Ocorreu algum erro de integração que impossibilitou que esta requisição de consulta da API obtivesse os dados solicitados.",
"content":{}
},
"504":{
"description":"Tempo Esgotado do Gateway - Ocorreu algum erro de rede e o gateway não respondeu a tempo. A requisição não chegou até a API Consulta CNPJ.",
