API de consulta de CNPJ en Brasil: situación, naturaleza jurídica, actividades CNAE y dirección

Actualizado en noviembre de 2026

Esta guía muestra cómo consultar una empresa en Brasil por CNPJ con la API de Verifik: el endpoint, sus parámetros, una solicitud que puedes pegar en la terminal, la respuesta y los errores documentados, y qué revisar al llevarlo a producción. Todo lo que sigue proviene de la documentación oficial del endpoint.

Registros empresariales en Brasil

El Cadastro Nacional da Pessoa Jurídica (CNPJ) es el registro nacional de personas jurídicas de la Receita Federal de Brasil. El número tiene 14 dígitos: ocho de la raíz de la empresa, cuatro de la sucursal (0001 es la matriz) y dos dígitos verificadores.

El endpoint de Verifik devuelve razón social, naturaleza jurídica, fecha de apertura, dirección y las actividades económicas principal y secundarias codificadas en CNAE.

Si ya tienes claro el caso de uso, crea una cuenta y prueba el endpoint desde tu código.

Cómo consultar la API de CNPJ de Brasil

Endpoint: GET https://api.verifik.co/v2/br/company. Envía tu token en la cabecera Authorization: Bearer. Parámetros, según la documentación:

Ejemplo de solicitud con valores de ejemplo (reemplázalos por los datos de tu usuario):

curl --location --request GET 'https://api.verifik.co/v2/br/company?documentType=CNPJ&documentNumber=45990181000189' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Respuesta 200 de la documentación (datos personales enmascarados):

{
  "data": {
    "address": {
      "city": "CAMPINAS",
      "complement": "KM 98",
      "district": "JARDIM EULINA",
      "state": "SP",
      "street": "ROD ANHANGUERA KM 98",
      "zipCode": "SN"
    },
    "businessName": "ROBERT BOSCH LIMITADA",
    "documentNumber": "45990181000189",
    "documentType": "CNPJ",
    "legalNature": "206-2 - Sociedade Empresária Limitada",
    "mainActivity": [
      {
        "code": "29.41-7-00",
        "description": "Fabricação de peças e acessórios para o sistema motor de veículos automotores"
      }
    ],
    "openingDate": "21/07/1966",
    "secondaryActivities": [
      {
        "code": "18.30-0-03",
        "description": "Reprodução de software em qualquer suporte"
      },
      {
        "code": "23.99-1-02",
        "description": "Fabricação de abrasivos"
      }
    ],
    "status": "ATIVA",
    "taxId": "45.990.181/0001-89",
    "tradeName": "",
    "type": "MATRIZ"
  },
  "signature": {
    "dateTime": "October 10, 2025 11:02 AM",
    "message": "Certified by Verifik.co"
  },
  "id": "2EM87"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: address, businessName, documentNumber, documentType, legalNature, mainActivity, openingDate, secondaryActivities, status, taxId, tradeName, type. Toda respuesta incluye además una signature (fecha y “Certified by Verifik.co”) y un id único que puedes guardar como evidencia de la verificación.

Errores documentados de /v2/br/company

• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 404 NotFound (“Record not found”): no se encontró registro; no lo trates como coincidencia y envía el caso a revisión o pide otro documento.
• 500 InternalServerError (“Server error”): error del servidor o de la fuente; reintenta con backoff y registra el id de la solicitud.

Consejos de integración

• Envía los 14 dígitos sin puntos, barra ni guion (la documentación exige no usar separadores).
• Las sucursales tienen su propio CNPJ (misma raíz, sufijo distinto). Asegúrate de consultar la entidad con la que contratas.
• Compara mainActivity con lo que el comercio dice hacer; una diferencia es una señal clásica de fraude de comercios.
• Valida los dos dígitos verificadores en tu sistema para no pagar por errores de digitación.

Datos personales y términos de uso

Los registros empresariales pueden incluir datos personales de socios, dignatarios o representantes. Usa la API solo con una finalidad legítima que puedas documentar, como onboarding, prevención de fraude o verificación contractual, obtén el consentimiento cuando la ley local lo exija y conserva solo los campos que necesites. El uso se rige por los términos y condiciones de smartCHECK.

Precios

Cada solicitud exitosa consume créditos de tu plan de Verifik. Los planes vigentes y el costo por endpoint están en la página de precios de smartCHECK.

Guías y documentación relacionadas

• API de verificación de CPF en Brasil
• API de consulta de CUIT en Argentina
• Documentación del endpoint (español)
• Documentación en inglés

Empieza a probar

Crea una cuenta en Verifik para obtener tu token de API, o agenda una reunión si quieres revisar cobertura y volúmenes con el equipo.