Nota Brasil API — Tabelas Fiscais Brasileiras (CFOP, NCM, CSOSN, CST)

Parâmetros comuns

Todas as rotas de listagem aceitam os mesmos parâmetros via query string.

Query parameters

Nome	Tipo	Padrão	Descrição
`search`	string	—	Filtra por `id` exato ou por correspondência parcial (case-insensitive) no campo `text`.
`page`	integer	`1`	Número da página. Mínimo `1`.
`size`	integer	`10`	Itens por página. Mínimo `10`, máximo `9999`.

Formato da resposta

{
  "page": 1,
  "size": 10,
  "total": 27,
  "items": [ /* ... */ ]
}

Limites do servidor

rate limit: 60 req/min CORS: GET, POST, OPTIONS JSON body: até 10 KB

Geral

Endpoint raiz para verificação de disponibilidade.

GET / Abrir

Retorna esta página de documentação.

Códigos Fiscais

Tabelas oficiais usadas em documentos fiscais eletrônicos.

GET /cfop Abrir

Código Fiscal de Operações e Prestações — identifica a natureza de circulação da mercadoria ou prestação de serviço.

Parâmetros

Aceita search, page e size (ver Parâmetros comuns).

Exemplo

GET /cfop?search=venda&page=1&size=10

cURL

curl "http://localhost:3000/cfop?search=venda&page=1&size=10"

GET /cnae Abrir

Classificação Nacional de Atividades Econômicas — identifica a atividade econômica principal do emitente ou destinatário da nota fiscal.

Parâmetros

Aceita search, page e size (ver Parâmetros comuns).

Exemplo

GET /cnae?search=cultivo&page=1&size=10

cURL

curl "http://localhost:3000/cnae?search=cultivo&page=1&size=10"

GET /ncm Abrir

Nomenclatura Comum do Mercosul — código de classificação de mercadorias.

Parâmetros

Aceita search, page e size.

Exemplo

GET /ncm?search=01012100

cURL

curl "http://localhost:3000/ncm?search=01012100"

GET /crt Abrir

Código de Regime Tributário — indica o regime fiscal do emitente (Simples Nacional, Lucro Presumido, etc.).

Parâmetros

Aceita search, page e size.

Exemplo

GET /crt?search=simples

cURL

curl "http://localhost:3000/crt?search=simples"

Tributação

Códigos de Situação Tributária para ICMS, PIS e COFINS.

GET /csosn Abrir

Código de Situação da Operação no Simples Nacional — usado por contribuintes optantes pelo Simples.

Parâmetros

Aceita search, page e size.

Exemplo

GET /csosn?search=101

cURL

curl "http://localhost:3000/csosn?search=101"

GET /cst-icsm Abrir

Código de Situação Tributária do ICMS.

Parâmetros

Aceita search, page e size.

Exemplo

GET /cst-icsm?search=00

cURL

curl "http://localhost:3000/cst-icsm?search=00"

GET /cst-pis Abrir

Código de Situação Tributária do PIS.

Parâmetros

Aceita search, page e size.

Exemplo

GET /cst-pis?search=tributada

cURL

curl "http://localhost:3000/cst-pis?search=tributada"

GET /cst-cofins Abrir

Código de Situação Tributária do COFINS.

Parâmetros

Aceita search, page e size.

Exemplo

GET /cst-cofins?search=01

cURL

curl "http://localhost:3000/cst-cofins?search=01"

Localidades

Tabelas geográficas brasileiras e internacionais.

GET /uf Abrir

Unidades Federativas do Brasil. Cada item contém id (código IBGE), code (sigla) e text (nome).

Parâmetros

Aceita search, page e size.

Exemplo

GET /uf?search=SP

cURL

curl "http://localhost:3000/uf?search=SP"

GET /municipios Abrir

Municípios brasileiros com códigos IBGE.

Parâmetros

Aceita search, page e size. Recomenda-se aumentar size ao listar sem filtro.

Exemplo

GET /municipios?search=são paulo&size=50

cURL

curl --get "http://localhost:3000/municipios" \
  --data-urlencode "search=são paulo" \
  --data-urlencode "size=50"

GET /paises Abrir

Lista de países segundo a tabela da Receita Federal (BACEN).

Parâmetros

Aceita search, page e size.

Exemplo

GET /paises?search=brasil

cURL

curl "http://localhost:3000/paises?search=brasil"

Operação

Tabelas auxiliares para preenchimento de notas fiscais.

GET /natureza Abrir

Naturezas de operação utilizadas em emissões fiscais.

Parâmetros

Aceita search, page e size.

Exemplo

GET /natureza?search=remessa

cURL

curl "http://localhost:3000/natureza?search=remessa"