Validate and normalize a Brazilian company tax ID, CNPJ (free)

Check digits, normalized 14-digit form, punctuated form, 8-digit root (economic group) and headquarters/branch flag. Pure arithmetic, no database lookup. Use it before paying: an invalid CNPJ never resolves in any paid endpoint.

get/v1/ferramentas/cnpj/{valor}

Request

  • Base URL: https://api.brazilayer.com
  • URL: https://api.brazilayer.com/v1/ferramentas/cnpj/{valor}
  • Auth: none declared

Path parameters

valorstring required

CNPJ with or without punctuation

Response

Validation result

validoboolean
motivo'formato_invalido' | 'digito_verificador_invalido' | 'null' nullable
cnpjstring

normalized 14 digits

formatadostring
raizstring

8-digit root

matrizboolean

true = headquarters

Example response

{
  "formatado": "00.000.000/0001-91"
}

Changes

No recorded changes to this operation across all 1 revision of this API.