TF Fiscal
Documentation

Identity lookup

CNPJ lookup

Official company registry data for a 14-digit CNPJ.

GET/openapi/v3/consultas/cnpj/{cnpj}
Requires the token, timestamp and sign signature headers, see Authentication.

Returns company registry data for a 14-digit corporate tax number: legal name, trade name, registration status, legal nature, CNAE activity code, registered address, contacts, share capital and Simples Nacional and MEI options.

The response is a bare object with no platform envelope. The field table lists every possible field; when the source holds no data for a field it comes back empty, and such fields are left out of the example. GET request: the signed body is the empty string and the CNPJ is part of the signed path.

Path parameters

cnpj*
stringCNPJ

* Required field

200
Lookup succeeded. Company registry data.
ni
stringCNPJ
tipoEstabelecimento
stringEstablishment type
nomeEmpresarial
stringLegal name
nomeFantasia
stringTrade name
objectRegistration status
objectLegal nature
dataAbertura
stringIncorporation date
objectMain CNAE
objectRegistered address
objectTax jurisdiction municipality
arrayPhone numbers
correioEletronico
stringE-mail address
capitalSocial
numberShare capital
porte
stringCompany size code
situacaoEspecial
stringSpecial status
dataSituacaoEspecial
stringSpecial status date
opcaoSimples
boolSimples option
opcaoMei
boolMEI option
arraySecondary activities
dataReferencia
stringReference date

opcaoSimples and opcaoMei can prefill optanteSimplesNacional and mei in Register company. Have the user confirm before sending:

opcaoMeiopcaoSimplesPrefillCRT
truetrue or falsemei=true, optanteSimplesNacional=true4 MEI
falsetruemei=false, optanteSimplesNacional=true1 Simples Nacional; if over the sublimit, switch to 2 in the console
falsefalsemei=false, optanteSimplesNacional=false3 Regime Normal
Either one emptyDo not prefill; ask the user—

Both fields come from the registry snapshot of dataReferencia, not from a real-time lookup: joining or leaving Simples after that date does not show yet. Being over the sublimit does not show in the public data. See "Tax regime" in Companies.

What this lookup does not return. It returns no state registration (IE) and does not tell Lucro Presumido from Lucro Real. The IE lives in the company record: sent as inscricaoEstadual at registration, or obtained from SEFAZ by automatic registration. Lucro Presumido or Real is the PIS/COFINS regime, set in the console.