Enrich Brazilian Company Data by CNPJ with cnpj.ia.br API

Enrich Brazilian company records by CNPJ—instantly

This n8n workflow looks up a Brazilian company using the cnpj.ia.br API, retries transient failures automatically, and outputs a clean, reduced company profile with key registration and contact fields.

What this workflow does

• Manual execution: The workflow runs when you manually trigger it in n8n.
• Set the target CNPJ: It assigns the CNPJ to query and initializes a retry counter.
• Fetch full company profile: It requests the complete company profile from cnpj.ia.br API for the provided CNPJ.
• Retry transient errors: If the API response includes an error marked as retryable, the workflow increments the retry counter, waits 2 seconds, and tries again (up to 2 retries).
• Fail fast on non-retryable issues: If the error is not retryable—or the maximum retries are reached—the workflow stops and raises an error containing the API error code.
• Return reduced output: On success, it extracts and returns key fields: razão social, situação cadastral, CNAE fiscal, porte, telephones, and email.

Use cases

• Verify and enrich customer/vendor data in your SaaS when users provide a CNPJ.
• Automate company lookup for onboarding workflows and KYC-style data normalization.
• Build reliable enrichment steps in n8n for lead qualification and contact enrichment.

Technical details

• Trigger: Manual Trigger
• HTTP integration: HTTP Request node calling cnpj.ia.br API using an HTTP Header Auth token
• Control logic: if, set, wait, stop and error
• Retry behavior: Retries up to 2 times with a 2-second delay between attempts

Set up your cnpj.ia.br API token, update the sample CNPJ, and use the workflow output to enrich Brazilian company records with consistent CNPJ-based data.