curl "https://api.cnpj-api.com/v1/simples/12345678000195?token=YOUR_TOKEN"
{
"cnpj": "12345678000195",
"atualizado_em": "2026-09-01T03:12:45.000Z",
"simples": {
"optante": true,
"data_opcao": "2020-06-05",
"data_exclusao": null
},
"simei": {
"optante": false,
"data_opcao": null,
"data_exclusao": null
}
}
Endpoints
Simples Nacional
Simples Nacional tax regime and MEI enrollment status
GET
/
v1
/
simples
/
{cnpj}
curl "https://api.cnpj-api.com/v1/simples/12345678000195?token=YOUR_TOKEN"
{
"cnpj": "12345678000195",
"atualizado_em": "2026-09-01T03:12:45.000Z",
"simples": {
"optante": true,
"data_opcao": "2020-06-05",
"data_exclusao": null
},
"simei": {
"optante": false,
"data_opcao": null,
"data_exclusao": null
}
}
string
required
CNPJ number without punctuation (14 characters). Example:
12345678000195.
The alphanumeric format in force since July 2026 is also accepted, where the first 12
positions may contain letters: 00000000E08G12. Lowercase letters are normalised.string
Authentication token. Preferred authentication method.
Data sources
Limited to 5 queries per minute for free tokens. See Rate Limits.Response
Receita Federal only publishes companies that have opted into Simples Nacional or MEI at some point. When the CNPJ is not in that data, the response is404.
string
CNPJ number without punctuation (14 characters), uppercased.
string
Date and time (ISO 8601) the data was last updated.
object
object
MEI registration (SIMEI), with the same fields as
simples.curl "https://api.cnpj-api.com/v1/simples/12345678000195?token=YOUR_TOKEN"
{
"cnpj": "12345678000195",
"atualizado_em": "2026-09-01T03:12:45.000Z",
"simples": {
"optante": true,
"data_opcao": "2020-06-05",
"data_exclusao": null
},
"simei": {
"optante": false,
"data_opcao": null,
"data_exclusao": null
}
}
Was this page helpful?