Sobre esta API

Lista empresas por estado, município, atividade econômica (CNAE) e situação cadastral, com CNPJ, razão social, nome fantasia, localização, situação e CNAE principal de cada uma.

Informe ao menos um filtro entre uf, municipio, cnae e situacao. Para a próxima página, envie o next_cursor da resposta em cursor.

Dados abertos da Receita Federal, atualizados todo mês — reference_month informa a competência. Gratuita, com limite de 20 consultas por minuto e 300 por dia.

Fonte dos dados

Receita Federal — dados abertos · Atualização: mensal

Requisição

GET /api/v1/cnpj

Endpoint público, sem autenticação. Respeite os limites de consulta.

Parâmetros

Campo	Tipo e local	Descrição
`uf` Opcional	stringquery	Sigla do estado. Exemplo: `SP`
`municipio` Opcional	integerquery	Código do município na tabela da Receita. Exemplo: `7107`
`cnae` Opcional	integerquery	CNAE principal, só dígitos. Exemplo: `6201501`
`situacao` Opcional	integerquery	1 nula, 2 ativa, 3 suspensa, 4 inapta, 8 baixada. Exemplo: `2`
`cursor` Opcional	stringquery	`next_cursor` devolvido na página anterior.
`limit` Opcional	integerquery	Tamanho da página, de 1 a 100. Exemplo: `20`

1curl --request GET 'https://api.apifordevs.com/api/v1/cnpj?uf=SP&municipio=7107&cnae=6201501&situacao=2&limit=20'

1import os
2import requests
3
4response = requests.request(
5    "GET",
6    "https://api.apifordevs.com/api/v1/cnpj?uf=SP&municipio=7107&cnae=6201501&situacao=2&limit=20",
7    timeout=30,
8)
9response.raise_for_status()
10print(response.json())

1const response = await fetch("https://api.apifordevs.com/api/v1/cnpj?uf=SP&municipio=7107&cnae=6201501&situacao=2&limit=20", {
2  method: "GET",
3  signal: AbortSignal.timeout(30000),
4});
5if (!response.ok) throw new Error(`HTTP ${response.status}`);
6console.log(await response.json());

Campos de resposta

Campos e tipos publicados no catálogo desta API.

Mês de referênciareference_monthstring
Data de extraçãoextracted_atstring
Itens na páginacountinteger
Próxima páginanext_cursorstring: Passe em cursor para a próxima página.
Empresasresultsarray
CNPJresults[].cnpjstring
Razão socialresults[].razao_socialstring
Nome fantasiaresults[].nome_fantasiastring
UFresults[].ufstring
Municípioresults[].municipiostring
Situação cadastralresults[].situacao_cadastralstring
CNAE principalresults[].cnae_principalinteger

Exemplo de resposta

1{
2  "success": true,
3  "code": 200,
4  "code_message": "A requisição foi processada com sucesso.",
5  "errors": [],
6  "header": null,
7  "data_count": 1,
8  "data": [
9    {
10      "reference_month": "2026-07",
11      "extracted_at": null,
12      "count": 1,
13      "next_cursor": "49670293000103",
14      "results": [
15        {
16          "cnpj": "49670293000103",
17          "razao_social": "COIN NODES LTDA",
18          "nome_fantasia": "COIN NODES",
19          "uf": "SP",
20          "municipio": "SAO PAULO",
21          "situacao_cadastral": "Ativa",
22          "cnae_principal": 6201501
23        }
24      ]
25    }
26  ]
27}

Respostas e cobrança

HTTP	Descrição	Cobrança
`200`	Sucesso. Filtro sem resultado também é `200`, com `results` vazio.	Sem cobrança
`422` `validation_error`	Nenhum filtro informado, `cursor` inválido ou parâmetro fora da faixa.	Sem cobrança
`429` `rate_limit_exceeded`	Limite de consultas por minuto ou por dia atingido.	Sem cobrança
`500` `internal_error`	Falha interna.	Sem cobrança
`503` `service_unavailable`	Base da Receita indisponível no momento.	Sem cobrança

Casos de uso

Prospecção por segmento

Listar empresas ativas de um CNAE numa cidade para montar carteira de vendas sem comprar lista de terceiro.

Estudo de mercado

Medir densidade de um setor por UF e município antes de abrir operação, com o número da fonte oficial.

Listagem de Pessoas Jurídicas