---
title: "Simples Nacional"
method: GET
path: "/simples/{cnpj}/days/{days}"
tags: ["API Comercial"]
---

# Simples Nacional

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

Método para recuperar as informações do **Simples Nacional** de uma
empresa brasileira através do seu CNPJ e respeitando a defasagem máxima
dos dados de acordo com o parâmetro `days`. Os dados retornados neste
endpoint são exatamente os mesmos disponíveis no acesso através do
site da Consulta de Optantes do Simples Nacional.

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

- union
  - SimplesResultSuccess
    - `cnpj` string
    - `simples` object — Informações sobre a opção pelo Simples Nacional
      - `optante` boolean — Indica se é optante pelo Simples
      - `data_opcao` string, date-time — Data de opção pelo Simples
      - `historico` object — Histórico de opções pelo Simples Nacional
        - `periodos_anteriores` object[]
          - `inicio` string — Data de início do período
          - `fim` string — Data de fim do período
          - `detalhamento` string — Detalhamento do período
    - `simei` object — Informações sobre a opção pelo SIMEI
      - `optante` boolean — Indica se é optante pelo SIMEI
      - `data_opcao` string, date-time — Data de opção pelo SIMEI
      - `historico` object — Histórico de opções pelo SIMEI
        - `periodos_anteriores` object[]
          - `inicio` string — Data de início do período
          - `fim` string — Data de fim do período
          - `detalhamento` string — Detalhamento do período
    - `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

## 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)