Brasil API icon

Brasil API

Consulta endpoints públicos da BrasilAPI

Overview

This node integrates with BrasilAPI, a public API providing various Brazilian data endpoints. Specifically, the "Corretora por CNPJ" operation fetches detailed information about a financial brokerage firm registered with the Brazilian Securities and Exchange Commission (CVM) by its CNPJ (Brazilian company registration number).

Use cases include:

  • Verifying brokerage firm details for compliance or due diligence.
  • Enriching customer or partner data with official brokerage information.
  • Automating financial data workflows that require brokerage identification.

Example: Given a valid CNPJ, the node returns structured data about the brokerage firm such as name, registration status, and other regulatory details.

Properties

Name Meaning
CNPJ The unique Brazilian company registration number (CNPJ) of the brokerage firm to query. It must be provided as a string in the format accepted by BrasilAPI.

Output

The node outputs JSON data containing the brokerage firm's information retrieved from BrasilAPI. The structure typically includes fields such as:

  • Official name of the brokerage.
  • Registration details with CVM.
  • Status and other regulatory attributes.

The exact fields depend on the API response but generally provide comprehensive data about the brokerage entity.

No binary data output is produced by this operation.

Dependencies

  • Requires internet access to call the BrasilAPI public endpoints.
  • No authentication or API keys are needed since BrasilAPI is publicly accessible.
  • The node uses HTTP GET requests with a timeout of 10 seconds per request.

Troubleshooting

  • Timeouts or network errors: Ensure the n8n instance has internet connectivity and BrasilAPI is reachable.
  • Invalid CNPJ input: Provide a correctly formatted CNPJ string; otherwise, the API may return an error or empty result.
  • Unsupported operation error: This occurs if the operation parameter is set incorrectly; verify that "Corretora por CNPJ" is selected.
  • Empty or unexpected responses: Check if the CNPJ exists in the CVM database or if BrasilAPI is temporarily down.

Links and References

Discussion