---
title: "Receita Federal"
method: GET
path: "/cnpj/{cnpj}/days/{days}"
tags: ["API Comercial"]
---

# Receita Federal

`GET /cnpj/{cnpj}/days/{days}`

Método para recuperar as informações da **Receita Federal** sobre uma
empresa brasileira através do seu CNPJ e respeitando a defasagem máxima
dos dados de acordo com o parâmetro `days`. As informações retornadas
neste endpoint são exatamente as mesmas disponíveis no site da
Receita Federal Brasileira.

Consulte informações sobre a API Comercial e seus detalhes [aqui](/).

## Path parameters

- `cnpj` string, required
- `days` number, required

## Query parameters

- `fallback` 'noCache' | 'cacheOnError'

## Response `200`

Sucesso (ver possíveis resultados)

- union
  - RfResultSuccess — Descrição da resposta
    - `status` string
    - `ultima_atualizacao` string, date-time — Data da última atualização dos dados
    - `cnpj` string — CNPJ da Empresa
    - `tipo` 'MATRIZ' | 'FILIAL' — Tipo da Empresa
    - `porte` string — Porte da Empresa
    - `nome` string — Razão Social
    - `fantasia` string — Nome Fantasia
    - `abertura` string — Data de Abertura
    - `atividade_principal` object[] — Atividade Principal
      - `code` string — Código da Atividade
      - `text` string — Descrição da Atividade
    - `atividades_secundarias` object[] — Atividades Secundárias
      - `code` string — Código da Atividade
      - `text` string — Descrição da Atividade
    - `natureza_juridica` string — Natureza Jurídica
    - `logradouro` string — Logradouro
    - `numero` string — Número
    - `complemento` string — Complemento
    - `cep` string — CEP
    - `bairro` string — Bairro
    - `municipio` string — Município
    - `uf` string — Estado
    - `email` string — Email
    - `telefone` string — Telefone
    - `efr` string — Ente Federativo Responsável
    - `situacao` string — Situação
    - `data_situacao` string — Data da Situação
    - `motivo_situacao` string — Motivo da Situação
    - `situacao_especial` string — Situação Especial
    - `data_situacao_especial` string — Data da Situação Especial
    - `capital_social` string — Capital Social
    - `qsa` object[] — Quadro Societário
      - `nome` string — Nome do Sócio
      - `qual` string — Qualificação do Sócio
      - `pais_origem` string — País de Origem do Sócio
      - `nome_rep_legal` string — Nome do Representante Legal
      - `qual_rep_legal` string — Qualificação do Representante Legal
    - `simples` object — Opção pelo regime tributário do Simples Nacional
      - `optante` boolean — Optante pelo Simples Nacional
      - `data_opcao` string, date-time — Data da Opção pelo Simples Nacional
      - `data_exclusao` string, date-time — Data da Exclusão do Simples Nacional
      - `ultima_atualizacao` string, date-time — Data da última atualização dos dados referentes ao Simples Nacional
    - `simei` object — Enquadramento no MEI (Microempreendedor Individual)
      - `optante` boolean — Optante pelo MEI
      - `data_opcao` string, date-time — Data da Opção pelo MEI
      - `data_exclusao` string, date-time — Data da Exclusão do MEI
      - `ultima_atualizacao` string, date-time — Data da última atualização dos dados referentes ao MEI
    - `billing` object — Informações sobre o uso de limites da consulta
      - `free` boolean — Indica se a consulta utilizou a API Gratuita
      - `database` boolean — Indica se a consulta foi resolvida com dados do cache
  - ResultInvalidCNPJ — CNPJ Inválido
    - `status` string
    - `message` string
  - RfResultRejected — CNPJ Rejeitado
    - `status` string
    - `message` string

## Other responses

- `402` — Limites de consulta excedido
- `504` — Timeout

---

[API](https://skmtc.net/receitaws/apis/receitaws-api.md) · [All operations](https://skmtc.net/receitaws/apis/receitaws-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/receitaws/receitaws-api/revisions/ea45e181b01b/schema)