curl "https://api.cnpj-api.com/v1/cidades/7107?token=YOUR_TOKEN"
{
"municipio_codigo": 7107,
"nome": "SAO PAULO",
"capital_social_total": 185432000000,
"empresas_maior_capital": [
{
"cnpj": "11222333000181",
"razao_social": "BETA PARTICIPACOES S.A.",
"nome_fantasia": "BETA",
"capital_social": 12000000000,
"data_abertura": "1998-03-17",
"situacao": {
"codigo": 2,
"descricao": "Ativa"
},
"municipio": "SAO PAULO",
"uf": "SP"
}
],
"empresas_recentes": [
{
"cnpj": "44555666000177",
"razao_social": "GAMA SERVICOS DIGITAIS LTDA",
"nome_fantasia": null,
"capital_social": 10000,
"data_abertura": "2026-08-28",
"situacao": {
"codigo": 2,
"descricao": "Ativa"
},
"municipio": "SAO PAULO",
"uf": "SP"
}
],
"socios_maior_capital": [
{
"pessoa_id": "***654321**",
"nome": "JOAO PEREIRA",
"tipo": "PESSOA_FISICA",
"qualificacao": {
"codigo": 16,
"descricao": "Presidente"
},
"cnpj": "11222333000181",
"razao_social": "BETA PARTICIPACOES S.A.",
"capital_social": 12000000000
}
]
}
Endpoints
Cities
Aggregated data for a municipality
GET
/
v1
/
cidades
/
{id}
curl "https://api.cnpj-api.com/v1/cidades/7107?token=YOUR_TOKEN"
{
"municipio_codigo": 7107,
"nome": "SAO PAULO",
"capital_social_total": 185432000000,
"empresas_maior_capital": [
{
"cnpj": "11222333000181",
"razao_social": "BETA PARTICIPACOES S.A.",
"nome_fantasia": "BETA",
"capital_social": 12000000000,
"data_abertura": "1998-03-17",
"situacao": {
"codigo": 2,
"descricao": "Ativa"
},
"municipio": "SAO PAULO",
"uf": "SP"
}
],
"empresas_recentes": [
{
"cnpj": "44555666000177",
"razao_social": "GAMA SERVICOS DIGITAIS LTDA",
"nome_fantasia": null,
"capital_social": 10000,
"data_abertura": "2026-08-28",
"situacao": {
"codigo": 2,
"descricao": "Ativa"
},
"municipio": "SAO PAULO",
"uf": "SP"
}
],
"socios_maior_capital": [
{
"pessoa_id": "***654321**",
"nome": "JOAO PEREIRA",
"tipo": "PESSOA_FISICA",
"qualificacao": {
"codigo": 16,
"descricao": "Presidente"
},
"cnpj": "11222333000181",
"razao_social": "BETA PARTICIPACOES S.A.",
"capital_social": 12000000000
}
]
}
number
required
SIAFI/TOM municipality code (used by Receita Federal). Example:
7107string
Authentication token. Preferred authentication method.
What’s included
- 100 largest companies by share capital
- 30 most recent companies by opening date
- 30 top partners linked to the highest-capital companies
Data sources
Limited to 5 queries per minute for free tokens. See Rate Limits.Response
Text comes as Receita Federal publishes it: uppercase, without accents. The lists include companies with any registration status, not only active ones.number
Municipality code from the Receita Federal table (TOM).
string
Municipality name.
number
Sum of the share capital of the companies in
empresas_maior_capital, in Brazilian reais. This is not the municipality’s total.object[]
The 100 companies with the largest share capital, largest first.
Show properties
Show properties
string
CNPJ number without punctuation (14 characters).
string
Legal name.
string | null
Trade name.
null when there is none.number
Share capital, in Brazilian reais.
string
Opening date (
YYYY-MM-DD).object
Registration status, with
codigo and descricao. Same codes as CNPJ Lookup.string
Municipality name.
string
State abbreviation.
object[]
The 30 most recently opened companies, newest first, in the same format as
empresas_maior_capital.object[]
30 partners of the companies in
empresas_maior_capital, ordered by the company’s share capital. A person who is a partner in several of those companies appears once per company.Show properties
Show properties
string
CPF as masked by Receita Federal (for example
***123456**) for individuals, or the CNPJ for companies.string
Partner’s name or legal name.
string
PESSOA_FISICA (individual), PESSOA_JURIDICA (company), ESTRANGEIRO (foreign resident) or DESCONHECIDO (unknown).object
The partner’s role, with
codigo and descricao (for example Sócio-Administrador, managing partner).string
CNPJ of the company the person is a partner in.
string
That company’s legal name.
number
That company’s share capital, in Brazilian reais.
curl "https://api.cnpj-api.com/v1/cidades/7107?token=YOUR_TOKEN"
{
"municipio_codigo": 7107,
"nome": "SAO PAULO",
"capital_social_total": 185432000000,
"empresas_maior_capital": [
{
"cnpj": "11222333000181",
"razao_social": "BETA PARTICIPACOES S.A.",
"nome_fantasia": "BETA",
"capital_social": 12000000000,
"data_abertura": "1998-03-17",
"situacao": {
"codigo": 2,
"descricao": "Ativa"
},
"municipio": "SAO PAULO",
"uf": "SP"
}
],
"empresas_recentes": [
{
"cnpj": "44555666000177",
"razao_social": "GAMA SERVICOS DIGITAIS LTDA",
"nome_fantasia": null,
"capital_social": 10000,
"data_abertura": "2026-08-28",
"situacao": {
"codigo": 2,
"descricao": "Ativa"
},
"municipio": "SAO PAULO",
"uf": "SP"
}
],
"socios_maior_capital": [
{
"pessoa_id": "***654321**",
"nome": "JOAO PEREIRA",
"tipo": "PESSOA_FISICA",
"qualificacao": {
"codigo": 16,
"descricao": "Presidente"
},
"cnpj": "11222333000181",
"razao_social": "BETA PARTICIPACOES S.A.",
"capital_social": 12000000000
}
]
}
Was this page helpful?