CNPJ Lookup

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=YOUR_TOKEN"

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=YOUR_TOKEN&formato=receitaws"

{
  "cnpj": "12345678000195",
  "razao_social": "ALFA COMERCIO DIGITAL LTDA",
  "nome_fantasia": "ALFA DIGITAL",
  "data_abertura": "2020-06-05",
  "matriz": true,
  "mei": false,
  "atualizado_em": "2026-09-01T03:12:45.000Z",
  "logo": null,
  "icone": null,
  "websites": null,
  "situacao": {
    "codigo": 2,
    "descricao": "Ativa"
  },
  "data_situacao": "2020-06-05",
  "situacao_especial": null,
  "data_situacao_especial": null,
  "telefones": [
    {
      "tipo": "PRINCIPAL",
      "ddd": "11",
      "numero": "32145678"
    }
  ],
  "emails": ["[email protected]"],
  "atividade_principal": {
    "codigo": 6311900,
    "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
  },
  "atividades_secundarias": [
    {
      "codigo": 6201501,
      "descricao": "Desenvolvimento de programas de computador sob encomenda"
    }
  ],
  "endereco": {
    "municipio_codigo": 7107,
    "tipo_logradouro": "AVENIDA",
    "logradouro": "BRIGADEIRO FARIA LIMA",
    "numero": "2369",
    "complemento": "CONJ 1102",
    "bairro": "JARDIM PAULISTANO",
    "cep": "01452922",
    "uf": "SP",
    "municipio": "SAO PAULO",
    "pais": {
      "codigo": 105,
      "nome": "BRASIL"
    }
  },
  "empresa": {
    "cnpj_basico": "12345678",
    "capital_social": 50000,
    "natureza_juridica": {
      "codigo": 2062,
      "descricao": "Sociedade Empresária Limitada"
    },
    "porte": {
      "codigo": 1,
      "sigla": "ME",
      "descricao": "Microempresa"
    },
    "simples": {
      "optante": true,
      "data_opcao": "2020-06-05",
      "data_exclusao": null
    },
    "simei": {
      "optante": false,
      "data_opcao": null,
      "data_exclusao": null
    },
    "socios": [
      {
        "data_entrada": "2020-06-05",
        "pessoa": {
          "id": "175f7cfb723ddf80cb5b7feebb0f80eb",
          "tipo": "PESSOA_FISICA",
          "nome": "MARIA OLIVEIRA",
          "cpf_cnpj": "***123456**",
          "faixa_etaria": "31-40"
        },
        "qualificacao": {
          "codigo": 49,
          "descricao": "Sócio-Administrador"
        }
      }
    ]
  }
}

GET

cnpj

{cnpj}

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=YOUR_TOKEN"

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=YOUR_TOKEN&formato=receitaws"

{
  "cnpj": "12345678000195",
  "razao_social": "ALFA COMERCIO DIGITAL LTDA",
  "nome_fantasia": "ALFA DIGITAL",
  "data_abertura": "2020-06-05",
  "matriz": true,
  "mei": false,
  "atualizado_em": "2026-09-01T03:12:45.000Z",
  "logo": null,
  "icone": null,
  "websites": null,
  "situacao": {
    "codigo": 2,
    "descricao": "Ativa"
  },
  "data_situacao": "2020-06-05",
  "situacao_especial": null,
  "data_situacao_especial": null,
  "telefones": [
    {
      "tipo": "PRINCIPAL",
      "ddd": "11",
      "numero": "32145678"
    }
  ],
  "emails": ["[email protected]"],
  "atividade_principal": {
    "codigo": 6311900,
    "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
  },
  "atividades_secundarias": [
    {
      "codigo": 6201501,
      "descricao": "Desenvolvimento de programas de computador sob encomenda"
    }
  ],
  "endereco": {
    "municipio_codigo": 7107,
    "tipo_logradouro": "AVENIDA",
    "logradouro": "BRIGADEIRO FARIA LIMA",
    "numero": "2369",
    "complemento": "CONJ 1102",
    "bairro": "JARDIM PAULISTANO",
    "cep": "01452922",
    "uf": "SP",
    "municipio": "SAO PAULO",
    "pais": {
      "codigo": 105,
      "nome": "BRASIL"
    }
  },
  "empresa": {
    "cnpj_basico": "12345678",
    "capital_social": 50000,
    "natureza_juridica": {
      "codigo": 2062,
      "descricao": "Sociedade Empresária Limitada"
    },
    "porte": {
      "codigo": 1,
      "sigla": "ME",
      "descricao": "Microempresa"
    },
    "simples": {
      "optante": true,
      "data_opcao": "2020-06-05",
      "data_exclusao": null
    },
    "simei": {
      "optante": false,
      "data_opcao": null,
      "data_exclusao": null
    },
    "socios": [
      {
        "data_entrada": "2020-06-05",
        "pessoa": {
          "id": "175f7cfb723ddf80cb5b7feebb0f80eb",
          "tipo": "PESSOA_FISICA",
          "nome": "MARIA OLIVEIRA",
          "cpf_cnpj": "***123456**",
          "faixa_etaria": "31-40"
        },
        "qualificacao": {
          "codigo": 49,
          "descricao": "Sócio-Administrador"
        }
      }
    ]
  }
}

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.

string

default:"default"

Response format for compatibility with other APIs:

default: Native format of this API (default)
receitaws: Compatible with ReceitaWS
cnpja: Compatible with CNPJa

Data sources

Data updated monthly from Receita Federal public files. Limited to 5 queries per minute for free tokens. See Rate Limits.

Response

The fields below describe the default format, returned when formato is omitted. With formato=receitaws or formato=cnpja, the response follows that API’s format instead: see Migrate from ReceitaWS and Migrate from CNPJa. Field names and text values are in Portuguese, as published by Receita Federal.

string

CNPJ number without punctuation (14 characters), uppercased.

Legal name of the company.

string

Trade name of the establishment. Omitted when Receita Federal does not report one.

string

Date the establishment was opened (YYYY-MM-DD).

boolean

true for the headquarters, false for branches.

boolean

true when the company is registered as an individual micro-entrepreneur (MEI, opted into SIMEI). Always present; false when the company never opted into Simples Nacional. Same value as empresa.simei.optante.

string

Date and time (ISO 8601) the data was last updated.

null

Always null on this endpoint. Use Logos & Websites to get the logo.

null

Always null on this endpoint. Use Logos & Websites to get the favicon.

null

Always null on this endpoint. Use Logos & Websites to get the company’s websites.

object

Registration status of the establishment.

Show properties

number

1 Nula (null), 2 Ativa (active), 3 Suspensa (suspended), 4 Inapta (unfit), 8 Baixada (closed).

string

Status description, for example Ativa.

string

Date of the current registration status (YYYY-MM-DD).

object

Reason for the registration status. Present only when the status is not Ativa and Receita Federal reports a reason.

Show properties

number

Reason code from the Receita Federal table.

string

Reason description, for example EXTINCAO POR ENCERRAMENTO LIQUIDACAO VOLUNTARIA.

string | null

Special status, for example judicial recovery. null when there is none.

string | null

Date of the special status (YYYY-MM-DD). null when there is none.

object[]

Registered phone numbers. Empty list when there are none.

Show properties

string

PRINCIPAL (main), SECUNDARIO (secondary) or FAX.

string

Area code.

string

Phone number, without the area code.

string[]

Registered email addresses, lowercased. Empty list when there are none.

object

Main economic activity (CNAE).

Show properties

number

7-digit CNAE code, without punctuation.

string

Activity description.

object[]

Secondary economic activities, in the same format as atividade_principal. Empty list when there are none.

object

Address of the establishment. Text comes as Receita Federal publishes it: uppercase, without accents.

Show properties

number

Municipality code from the Receita Federal table (TOM). This is not the IBGE code.

string

Street type, for example RUA or AVENIDA.

string

Street name, without the street type.

string

Street number. Can be text such as S/N (no number).

string

Address complement. Empty string when there is none.

string

Neighborhood.

string

8-digit postal code (CEP), without punctuation.

string

State abbreviation.

string

Municipality name.

object

Country, with codigo (Receita Federal table) and nome.

object

The company the establishment belongs to. The same for the headquarters and every branch.

Show properties

string

First 8 digits of the CNPJ, shared by every establishment of the company.

Share capital, in Brazilian reais.

string

Responsible federative entity. Present only for public bodies (natureza_juridica.codigo below 2000).

object

Legal nature, with codigo (for example 2062) and descricao (for example Sociedade Empresária Limitada).

object

Company size: codigo (1 ME, micro company; 3 EPP, small company; 5 Demais, other), sigla and descricao.

object

Simples Nacional tax regime. Omitted when the company never opted in.

Show properties

boolean

true when the company is currently opted in.

string | null

Opt-in date (YYYY-MM-DD).

string | null

Exclusion date (YYYY-MM-DD). null when the company was not excluded.

object

MEI registration (SIMEI), with the same fields as simples. Omitted when the company never opted into Simples Nacional.

object[]

Partners and administrators (QSA). Empty list when there are none.

Show properties

string

Date the partner joined the company (YYYY-MM-DD).

object

The partner or administrator.

Show properties

string

Stable identifier for the person, derived from their type, CPF/CNPJ and name.

string

PESSOA_FISICA (individual), PESSOA_JURIDICA (company), ESTRANGEIRO (foreign resident) or DESCONHECIDO (unknown).

string

Name or legal name.

string

The partner’s CNPJ, or their CPF as masked by Receita Federal (for example ***123456**). Omitted when not reported.

string

Age range, from 0-12 to 81+. Present only for PESSOA_FISICA.

object

Country of origin, with codigo and nome. Present only for ESTRANGEIRO.

object

The partner’s role, with codigo and descricao (for example Sócio-Administrador, managing partner).

object

The partner’s legal representative, with pessoa and qualificacao in the same format as above. Present only when Receita Federal reports one.

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=YOUR_TOKEN"

curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=YOUR_TOKEN&formato=receitaws"

{
  "cnpj": "12345678000195",
  "razao_social": "ALFA COMERCIO DIGITAL LTDA",
  "nome_fantasia": "ALFA DIGITAL",
  "data_abertura": "2020-06-05",
  "matriz": true,
  "mei": false,
  "atualizado_em": "2026-09-01T03:12:45.000Z",
  "logo": null,
  "icone": null,
  "websites": null,
  "situacao": {
    "codigo": 2,
    "descricao": "Ativa"
  },
  "data_situacao": "2020-06-05",
  "situacao_especial": null,
  "data_situacao_especial": null,
  "telefones": [
    {
      "tipo": "PRINCIPAL",
      "ddd": "11",
      "numero": "32145678"
    }
  ],
  "emails": ["[email protected]"],
  "atividade_principal": {
    "codigo": 6311900,
    "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
  },
  "atividades_secundarias": [
    {
      "codigo": 6201501,
      "descricao": "Desenvolvimento de programas de computador sob encomenda"
    }
  ],
  "endereco": {
    "municipio_codigo": 7107,
    "tipo_logradouro": "AVENIDA",
    "logradouro": "BRIGADEIRO FARIA LIMA",
    "numero": "2369",
    "complemento": "CONJ 1102",
    "bairro": "JARDIM PAULISTANO",
    "cep": "01452922",
    "uf": "SP",
    "municipio": "SAO PAULO",
    "pais": {
      "codigo": 105,
      "nome": "BRASIL"
    }
  },
  "empresa": {
    "cnpj_basico": "12345678",
    "capital_social": 50000,
    "natureza_juridica": {
      "codigo": 2062,
      "descricao": "Sociedade Empresária Limitada"
    },
    "porte": {
      "codigo": 1,
      "sigla": "ME",
      "descricao": "Microempresa"
    },
    "simples": {
      "optante": true,
      "data_opcao": "2020-06-05",
      "data_exclusao": null
    },
    "simei": {
      "optante": false,
      "data_opcao": null,
      "data_exclusao": null
    },
    "socios": [
      {
        "data_entrada": "2020-06-05",
        "pessoa": {
          "id": "175f7cfb723ddf80cb5b7feebb0f80eb",
          "tipo": "PESSOA_FISICA",
          "nome": "MARIA OLIVEIRA",
          "cpf_cnpj": "***123456**",
          "faixa_etaria": "31-40"
        },
        "qualificacao": {
          "codigo": 49,
          "descricao": "Sócio-Administrador"
        }
      }
    ]
  }
}

Introduction

Authentication

Endpoints

Skill CNPJ

Migration

Support

Data sources

Response

​Data sources

​Response

Data sources

Response