Batch CNPJ lookup: up to 1,000 CNPJs per request
Send a list of CNPJs, numeric or alphanumeric, and get the legal name, registration status, activity and partners of each one. Processing runs in the background and you are notified when it ends.
Only the CNPJs found spend credits. Free sandbox.
Batch progress
- Total
- 500 CNPJs
- Found
- 497
- Not found
- 2
- Invalid
- 1
Portfolio analysis without spreadsheets
The same response as the single CNPJ lookup, for the whole list.
- Up to 1,000 CNPJs per request
- With or without punctuation, numeric or alphanumeric. A list with just the CNPJ strings also works.
- The same data as the single lookup
- Legal name, status, CNAE, company size, address, Simples and MEI and the partners of each company.
- Item-by-item validation
- Format and check digits are checked on entry. An invalid item does not bring the batch down and is not charged.
- Asynchronous processing
- The API answers 202 with the batch_id and works in the background. Follow the status or receive the batch.completed webhook.
- Paginated results
- Each CNPJ comes back with a status (found, not found, invalid or error), available for 24 hours.
- Federal Revenue open data
- The source is the same as the single lookup: the CNPJ open data, up to 30 days behind.
How it works
- 1
You send the list
The API validates the format and check digits of each item and queues the processing. The 202 response carries the batch_id.
- 2
Processing runs in the background
Each CNPJ is resolved in the open data, and only the ones found are charged.
- 3
You follow along and read the results
Check the status until completed, or wait for the webhook. Results stay available for 24 hours.
Send the list, follow up later
One POST with the list of CNPJs returns the batch_id to follow the batch.
Endpoint documentationcURL POST /v1/cnpj/batch
Response
Batch accepted. Follow it by its batch_id.
Not enough balance to cover the batch: nothing was processed.
What it costs
1 credit per CNPJ found
Invalid items, not found items and source failures are not charged. Your balance must cover the whole batch unless your plan allows overage.
Free sandbox
Sandbox keys (brz_test_) process the batch with test CNPJs and never debit your balance.
Same balance as CPF
Plan credits work for CPF and CNPJ lookups, single or batch, and for the dossier.
Where to use it
B2B portfolio analysis
Find which customers have a closed, unfit or suspended company before renewing contracts.
Supplier vetting
Check status, activity and partners of your whole supplier base in one run.
Lead enrichment
Complete prospecting lists with the size, activity and location of each company.
Frequently asked questions
What is the maximum batch size?
Up to 1,000 CNPJs per request. For bigger lists, send several batches in sequence.
Does the batch accept alphanumeric CNPJ?
Yes. Since July 2026 the Federal Revenue issues CNPJs with letters and numbers, and validation and lookup work for both formats.
Where does the data come from?
From the CNPJ open data published by the Federal Revenue. It is not a real-time query to the Revenue system: the data reflects the latest publication, up to 30 days behind.
How long do the results stay available?
For 24 hours after submission. To keep them, store the results in your own system.
How am I notified when the batch ends?
Register a webhook in the dashboard and receive the batch.completed event, which carries only counters and dates. You read the results through the API.
More BrazID products
They all share the same API key and the same credit balance.
Validate your whole company portfolio
Create your account, test the batch in the sandbox and process your CNPJ list in minutes.
Only the CNPJs found spend credits. Free sandbox.