Brasil Hub icon

Brasil Hub

Query Brazilian public data (CNPJ, CEP, CPF, Banks, Câmbio, DDD, Holidays, FIPE, IBGE, NCM, PIX, Taxas) with multi-provider fallback

Actions28

CNPJ → Query

AI-generated

Summary

Query detailed information about a Brazilian legal entity by its CNPJ number using multiple data providers with automatic fallback.

Inputs

  • CNPJ (required) — The CNPJ number to query or validate, with or without formatting, e.g., '11.222.333/0001-81'.
  • Primary Provider — Select which provider to try first for the query. Options include 'Auto (BrasilAPI First)', 'BrasilAPI', 'CNPJ.ws', 'CNPJA', 'MinhaReceita', 'OpenCNPJ.com', 'OpenCNPJ.org', and 'ReceitaWS'. Default is 'auto' which prioritizes BrasilAPI first.
  • Simplify — Boolean flag to return a simplified response containing only the most important fields when true. Defaults to true.
  • Output Mode — When Simplify is false, choose the output format: 'Full' returns all normalized fields including address, contacts, and partners; 'AI Summary' returns a flat key-value object optimized for AI agent tools. Defaults to 'Full'.
  • Include Raw Response — Boolean flag to include the raw API response alongside normalized data. Defaults to false.
  • Timeout (Ms) — HTTP request timeout in milliseconds for each provider attempt, with a minimum of 1000ms and maximum of 60000ms. Defaults to 10000ms.

Output shape

a single JSON object containing normalized CNPJ data according to selected output settings, optionally including the raw API response.

The result attempts to query using the primary provider first and falls back to other configured providers if needed. If 'Simplify' is enabled, output is a reduced dataset of key fields. If disabled, output respects the 'Output Mode' setting. Raw responses are optionally included. Each request respects the configured timeout per provider.

Examples

Example 1: Query CNPJ with default settings

Provide a CNPJ number, use default 'Auto (BrasilAPI First)' provider, Simplify enabled, and default timeout. Returns key entity information in simplified form.

Example 2: Query full detailed CNPJ information

Provide a CNPJ number, set Simplify to false, and select 'Full' output mode. Returns complete normalized data including address, contacts, and partners.

Links

Discussion