# Brazil CNPJ Receita Federal Crawler (`solidcode/brazil-cnpj-receita-federal-crawler`) Actor

\[💰 $0.99 / 1K] Look up Brazilian companies from the Receita Federal CNPJ registry. Search by CNPJ, state, activity (CNAE), city, or legal form. Get name, status, address, contacts, capital, activities, tax flags, and partners (QSA).

- **URL**: https://apify.com/solidcode/brazil-cnpj-receita-federal-crawler.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Developer tools, Lead generation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Brazil CNPJ Receita Federal Crawler

Look up any Brazilian company by its CNPJ and get the full official Receita Federal registry record — legal identity, registration status, address, contacts, business activities, share capital, tax profile, and the complete partner list — in clean JSON. Paste one CNPJ or ten thousand, or discover companies by state, activity, city, and legal form. Built for sales, compliance, and research teams who need verified Brazilian company data without wrestling government portals one search at a time.

### Why This Scraper?

- **Bulk CNPJ enrichment with no per-run cap** — paste 10 or 10,000 CNPJ numbers and get a full record for every one, with no volume limit on direct lookups.
- **Punctuation-tolerant input** — accepts CNPJs in any format, `11.222.333/0001-81` or `11222333000181`, and normalizes them automatically. No pre-cleaning required.
- **Complete partner list (QSA)** — every partner with name, role (qualificação), entry date, and age range, plus a `partnerCount` on each company for instant ownership sizing.
- **Full activity profile** — primary CNAE code and description, plus every secondary CNAE code with its plain-language description.
- **Tax status at a glance** — Simples Nacional and MEI opt-in flags with their opt-in and opt-out dates, plus a year-by-year tax-regime history.
- **Registration status with reason and date** — resolves across all 5 official statuses: ATIVA, SUSPENSA, INAPTA, BAIXADA, and NULA.
- **7-part address breakdown** — street, number, complement, neighborhood, city, state, and CEP as separate fields, plus up to two phone numbers, a fax line, and email.
- **Headquarters vs. branch flag** — each row marks whether the establishment is the matriz (head office) or a filial (branch).
- **Discovery across all 27 Brazilian states** — sample companies by state (UF), CNAE activity, city, legal form, and registration status when you don't yet have CNPJ numbers.

### Use Cases

**Lead Generation & Sales Prospecting**
- Build B2B contact lists with company email, phone, and full postal address
- Enrich existing lead lists with official trade names, size, and activity codes
- Qualify prospects by company size (porte) and share capital before outreach
- Target suppliers or buyers by CNAE activity in a specific state or city

**Compliance, KYC & Due Diligence**
- Verify a counterparty's legal name, CNPJ, and active/closed registration status
- Screen the full partner (QSA) structure for ownership and control checks
- Confirm tax standing via Simples Nacional and MEI flags before onboarding
- Document opening date, status reason, and status date for audit trails

**Supplier & Partner Vetting**
- Validate that a vendor's CNPJ is ATIVA and not BAIXADA (closed) or SUSPENSA
- Cross-check registered activity codes against the services a supplier offers
- Review share capital and company size to gauge counterparty stability
- Confirm the head-office vs. branch status of the entity you're contracting

**Market & Competitive Research**
- Sample companies operating under a given CNAE activity across states
- Map competitor concentration by city and legal form
- Analyze the mix of company sizes and legal structures in a sector
- Track registration status distribution within a target market segment

### Getting Started

#### Look up specific companies

The simplest way to start — paste the CNPJs you already have:

```json
{
    "cnpjs": ["33.000.167/0001-01", "00000000000191"]
}
````

#### Discover companies by filter

Leave `cnpjs` empty and sample companies matching your criteria:

```json
{
    "state": "SP",
    "status": "ATIVA",
    "maxResults": 20
}
```

#### Combined, targeted discovery

Stack filters to narrow to exactly the companies you want:

```json
{
    "state": "PR",
    "city": "CURITIBA",
    "activityCode": "6201500",
    "legalFormCode": "2062",
    "status": "ATIVA",
    "maxResults": 20
}
```

### Input Reference

#### What to Look Up

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `cnpjs` | string\[] | `[]` | One or more CNPJ numbers to look up directly, with or without punctuation. When provided, the filters below are ignored and every listed company is returned in full. |

#### Discovery Filters

Used only when `cnpjs` is empty. Companies must match every filter you set.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `state` | select | `All states` | Brazilian state (UF) to search, e.g. São Paulo (SP) or Rio de Janeiro (RJ). Covers all 27 states. |
| `activityCode` | string | `""` | 7-digit CNAE activity code, e.g. `6201500` (software) or `4711301` (supermarkets). Matches primary or secondary activity. |
| `city` | string | `""` | City name, e.g. `SAO PAULO` or `RIO DE JANEIRO`. Accents optional. |
| `legalFormCode` | string | `""` | 4-digit legal-form (natureza jurídica) code, e.g. `2062` (limited company) or `2135` (sole proprietor). |
| `status` | select | `Any status` | Registration status: Active (ATIVA), Suspended (SUSPENSA), Ineligible (INAPTA), Closed (BAIXADA), or Null (NULA). |

#### Limits

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxResults` | integer | `100` | How many companies to collect. Set to `0` for as many as possible. Direct CNPJ lookups always return every company you list, regardless of this cap. |

### Output

Each row is one company establishment (head office or branch) as a flat JSON object. Fields the registry leaves blank are omitted.

```json
{
    "cnpj": "00000000000191",
    "cnpjFormatted": "00.000.000/0001-91",
    "companyName": "BANCO DO BRASIL SA",
    "tradeName": "DIRECAO GERAL",
    "establishmentType": "MATRIZ",
    "registrationStatus": "ATIVA",
    "registrationStatusReason": "SEM MOTIVO",
    "registrationStatusDate": "2005-11-03",
    "openingDate": "1966-08-01",
    "companySize": "DEMAIS",
    "shareCapital": 120000000000.0,
    "legalForm": "Sociedade de Economia Mista",
    "legalFormCode": "2038",
    "primaryActivityCode": "6422100",
    "primaryActivityDescription": "Bancos multiplos, com carteira comercial",
    "secondaryActivities": [
        { "code": "6499999", "description": "Outras atividades de servicos financeiros" }
    ],
    "street": "SBS QUADRA 01 BLOCO G LOTE 32",
    "number": "S/N",
    "complement": "EDIFICIO SEDE III",
    "neighborhood": "ASA SUL",
    "city": "BRASILIA",
    "state": "DF",
    "zipCode": "70073901",
    "country": "BRASIL",
    "phone1": "6134939002",
    "phone2": "6134933002",
    "email": "sede@bb.com.br",
    "simplesNacional": false,
    "mei": false,
    "taxRegimes": [
        { "year": 2020, "taxation": "LUCRO REAL" }
    ],
    "partners": [
        { "name": "MARIA DE FATIMA EXAMPLE", "role": "Diretor", "since": "2019-04-25", "ageRange": "51 a 60 anos" }
    ],
    "partnerCount": 1,
    "sourceUrl": "https://www.gov.br/receitafederal/cnpj/00000000000191"
}
```

#### Core Identity

| Field | Type | Description |
|-------|------|-------------|
| `cnpj` | string | 14-digit CNPJ, digits only |
| `cnpjFormatted` | string | CNPJ with standard punctuation (`00.000.000/0001-91`) |
| `companyName` | string | Official legal name (razão social) |
| `tradeName` | string | Trade name (nome fantasia) |
| `establishmentType` | string | MATRIZ (head office) or FILIAL (branch) |
| `companySize` | string | Company size band (porte) |
| `shareCapital` | number | Registered share capital in BRL |
| `legalForm` | string | Legal form description (natureza jurídica) |
| `legalFormCode` | string | 4-digit legal-form code |
| `openingDate` | string | Date the establishment opened |

#### Registration Status

| Field | Type | Description |
|-------|------|-------------|
| `registrationStatus` | string | ATIVA, SUSPENSA, INAPTA, BAIXADA, or NULA |
| `registrationStatusReason` | string | Reason text for the current status |
| `registrationStatusDate` | string | Date the current status took effect |

#### Activities

| Field | Type | Description |
|-------|------|-------------|
| `primaryActivityCode` | string | 7-digit primary CNAE code |
| `primaryActivityDescription` | string | Primary activity in plain language |
| `secondaryActivities` | object\[] | Secondary activities, each `{ code, description }` |

#### Address & Contact

| Field | Type | Description |
|-------|------|-------------|
| `street` | string | Street type and name |
| `number` | string | Street number |
| `complement` | string | Address complement |
| `neighborhood` | string | Neighborhood (bairro) |
| `city` | string | City (município) |
| `state` | string | State (UF) |
| `zipCode` | string | Postal code (CEP) |
| `country` | string | Country |
| `phone1` | string | Primary phone (with area code) |
| `phone2` | string | Secondary phone |
| `fax` | string | Fax number |
| `email` | string | Registered email |

#### Tax Profile

| Field | Type | Description |
|-------|------|-------------|
| `simplesNacional` | boolean | Enrolled in Simples Nacional |
| `simplesNacionalOptIn` | string | Simples Nacional opt-in date |
| `simplesNacionalOptOut` | string | Simples Nacional opt-out date |
| `mei` | boolean | Registered as MEI (micro-entrepreneur) |
| `meiOptIn` | string | MEI opt-in date |
| `meiOptOut` | string | MEI opt-out date |
| `taxRegimes` | object\[] | Tax-regime history, each `{ year, taxation }` |
| `federativeEntity` | string | Responsible federative entity (for public bodies) |

#### Partners & Source

| Field | Type | Description |
|-------|------|-------------|
| `partners` | object\[] | Partner list (QSA), each `{ name, role, since, maskedId, ageRange }` |
| `partnerCount` | number | Number of partners on the record |
| `sourceUrl` | string | Official registry URL for the record |

### Tips for Best Results

- **Have CNPJs? Paste them directly.** Direct lookups have no volume cap and always return the full record, so a CNPJ list is the fastest, most complete path for enrichment, KYC, and due-diligence workflows.
- **Discovery returns a curated sample — combine filters to go deeper.** The public company directory returns up to about 20 companies per filter combination. To reach more companies, stack several filters (state + activity + city + legal form) to run many precise searches instead of one broad one, then feed the CNPJs you collect back in through `cnpjs` for full records.
- **Don't bother cleaning your CNPJs.** Mixed formats in the same list work fine — `11.222.333/0001-81` and `11222333000181` are treated identically, so you can paste straight from a spreadsheet.
- **Use `status: ATIVA` to skip dead entities.** Filtering to active registrations avoids closed (BAIXADA) and suspended companies when you only want operating businesses.
- **CNAE codes match primary and secondary activities.** A single `activityCode` catches companies that list your target activity anywhere in their profile, not just as their main line of business.
- **Check `establishmentType` before you contact.** MATRIZ is the head office and FILIAL is a branch — route correspondence and contracts to the right one.
- **Start small, then scale.** Run a handful of CNPJs first to confirm the fields you need are populated, then submit your full list.

### Pricing

**From $0.99 per 1,000 results** — a flat rate per company record, whichever tier you're on. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.12 | $0.11 | $0.11 | $0.10 |
| 1,000 | $1.15 | $1.10 | $1.05 | $0.99 |
| 10,000 | $11.50 | $11.00 | $10.50 | $9.90 |
| 100,000 | $115.00 | $110.00 | $105.00 | $99.00 |

No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. A "result" is any company row in the output dataset.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom APIs on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor collects publicly available company registry data published by Brazil's federal tax authority (Receita Federal). Use it for legitimate purposes such as lead generation, compliance, due diligence, and market research. You are responsible for using the data lawfully, including compliance with Brazil's data protection law (LGPD) and any applicable terms of use. Do not use the data for spam, harassment, or any unlawful activity.

# Actor input Schema

## `cnpjs` (type: `array`):

Look up specific companies directly by their CNPJ (the 14-digit Brazilian company tax ID). Paste one or more — with or without punctuation, e.g. '11.222.333/0001-81' or '11222333000181'. When you provide CNPJs here, the filters below are ignored and only these companies are returned.

## `state` (type: `string`):

Discover companies registered in this Brazilian state. Only used when no CNPJ numbers are given above. Leave on 'All states' to search across the whole country.

## `activityCode` (type: `string`):

Keep only companies in this business activity. Enter a CNAE code such as '6201500' (software development) or '4711301' (supermarkets). Matches the company's primary or secondary activity. Leave blank for any activity.

## `city` (type: `string`):

Keep only companies in this city. Enter the city name, e.g. 'SAO PAULO' or 'RIO DE JANEIRO' (accents are optional). Leave blank for any city.

## `legalFormCode` (type: `string`):

Keep only companies of a specific legal form (natureza jurídica). Enter the code, e.g. '2062' for a limited liability company (Sociedade Empresária Limitada) or '2135' for a sole proprietor (Empresário Individual). Leave blank for any legal form.

## `status` (type: `string`):

Keep only companies with this registration status. 'Active' returns operating companies only. 'Any status' also includes suspended, closed, and ineligible registrations.

## `maxResults` (type: `integer`):

How many companies to collect. The actor stops once this number is reached but keeps the full last page, so results may slightly overshoot. Set to 0 to collect as many as possible. CNPJ lookups always return every company you list, regardless of this cap. Note for bulk discovery: the public company directory returns up to about 20 companies per filter combination, so a single broad filter (e.g. just one state) returns roughly 20 companies even if you ask for more. To collect larger volumes, combine several filters (state + activity + city) to run many targeted searches, or paste CNPJ numbers directly above — direct lookups have no such limit.

## Actor input object example

```json
{
  "cnpjs": [
    "11222333000181"
  ],
  "state": "",
  "status": "",
  "maxResults": 100
}
```

# Actor output Schema

## `overview` (type: `string`):

Key company fields: CNPJ, name, status, activity, location, and partner count.

## `contacts` (type: `string`):

Contact and address details for each company.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "cnpjs": [
        "11222333000181"
    ],
    "state": "",
    "activityCode": "",
    "city": "",
    "legalFormCode": "",
    "status": "",
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/brazil-cnpj-receita-federal-crawler").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "cnpjs": ["11222333000181"],
    "state": "",
    "activityCode": "",
    "city": "",
    "legalFormCode": "",
    "status": "",
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/brazil-cnpj-receita-federal-crawler").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "cnpjs": [
    "11222333000181"
  ],
  "state": "",
  "activityCode": "",
  "city": "",
  "legalFormCode": "",
  "status": "",
  "maxResults": 100
}' |
apify call solidcode/brazil-cnpj-receita-federal-crawler --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=solidcode/brazil-cnpj-receita-federal-crawler",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Brazil CNPJ Receita Federal Crawler",
        "description": "[💰 $0.99 / 1K] Look up Brazilian companies from the Receita Federal CNPJ registry. Search by CNPJ, state, activity (CNAE), city, or legal form. Get name, status, address, contacts, capital, activities, tax flags, and partners (QSA).",
        "version": "1.0",
        "x-build-id": "GxeoHEJjVo2SYUsiD"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/solidcode~brazil-cnpj-receita-federal-crawler/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-solidcode-brazil-cnpj-receita-federal-crawler",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/solidcode~brazil-cnpj-receita-federal-crawler/runs": {
            "post": {
                "operationId": "runs-sync-solidcode-brazil-cnpj-receita-federal-crawler",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/solidcode~brazil-cnpj-receita-federal-crawler/run-sync": {
            "post": {
                "operationId": "run-sync-solidcode-brazil-cnpj-receita-federal-crawler",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "cnpjs": {
                        "title": "CNPJ numbers",
                        "type": "array",
                        "description": "Look up specific companies directly by their CNPJ (the 14-digit Brazilian company tax ID). Paste one or more — with or without punctuation, e.g. '11.222.333/0001-81' or '11222333000181'. When you provide CNPJs here, the filters below are ignored and only these companies are returned.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "state": {
                        "title": "State (UF)",
                        "enum": [
                            "",
                            "AC",
                            "AL",
                            "AP",
                            "AM",
                            "BA",
                            "CE",
                            "DF",
                            "ES",
                            "GO",
                            "MA",
                            "MT",
                            "MS",
                            "MG",
                            "PA",
                            "PB",
                            "PR",
                            "PE",
                            "PI",
                            "RJ",
                            "RN",
                            "RS",
                            "RO",
                            "RR",
                            "SC",
                            "SP",
                            "SE",
                            "TO"
                        ],
                        "type": "string",
                        "description": "Discover companies registered in this Brazilian state. Only used when no CNPJ numbers are given above. Leave on 'All states' to search across the whole country.",
                        "default": ""
                    },
                    "activityCode": {
                        "title": "Activity code (CNAE)",
                        "type": "string",
                        "description": "Keep only companies in this business activity. Enter a CNAE code such as '6201500' (software development) or '4711301' (supermarkets). Matches the company's primary or secondary activity. Leave blank for any activity."
                    },
                    "city": {
                        "title": "City",
                        "type": "string",
                        "description": "Keep only companies in this city. Enter the city name, e.g. 'SAO PAULO' or 'RIO DE JANEIRO' (accents are optional). Leave blank for any city."
                    },
                    "legalFormCode": {
                        "title": "Legal form code",
                        "type": "string",
                        "description": "Keep only companies of a specific legal form (natureza jurídica). Enter the code, e.g. '2062' for a limited liability company (Sociedade Empresária Limitada) or '2135' for a sole proprietor (Empresário Individual). Leave blank for any legal form."
                    },
                    "status": {
                        "title": "Registration status",
                        "enum": [
                            "",
                            "ATIVA",
                            "SUSPENSA",
                            "INAPTA",
                            "BAIXADA",
                            "NULA"
                        ],
                        "type": "string",
                        "description": "Keep only companies with this registration status. 'Active' returns operating companies only. 'Any status' also includes suspended, closed, and ineligible registrations.",
                        "default": ""
                    },
                    "maxResults": {
                        "title": "Maximum results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "How many companies to collect. The actor stops once this number is reached but keeps the full last page, so results may slightly overshoot. Set to 0 to collect as many as possible. CNPJ lookups always return every company you list, regardless of this cap. Note for bulk discovery: the public company directory returns up to about 20 companies per filter combination, so a single broad filter (e.g. just one state) returns roughly 20 companies even if you ask for more. To collect larger volumes, combine several filters (state + activity + city) to run many targeted searches, or paste CNPJ numbers directly above — direct lookups have no such limit.",
                        "default": 100
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```