Migrating from ReceitaWS
Migration from ReceitaWS is straightforward. The/cnpj/{cnpj} endpoint supports the formato=receitaws parameter, which returns the response in the same format as the ReceitaWS API.
Step 1: Change the base URL
Step 2: Add authentication
Add thetoken parameter to the URL or the Authorization: Bearer {token} header.
Step 3: Test
The response will have the same format as ReceitaWS. No changes to parsing are required.Differences
| Aspect | ReceitaWS | This API |
|---|---|---|
| Authentication | Varies by plan | Token via URL or header |
| Rate limit | Varies by plan | 5 req/min (free) |
| Extra data | Registration only | Registration + logos + Simples |
| Native format | Proprietary | Proprietary (with compatibility) |
When to remove the formato parameter
We recommend that, after validating the migration, you remove the formato=receitaws parameter and adapt your code to this API’s native format. The native format offers more fields and better structured data.