{
  "data": {
    "id": "6kgHQbsDVdjDvE7Eo",
    "actId": "cNSljbP1ozrKhKG5H",
    "userId": "zq8lKbpLzTjGDayPC",
    "startedAt": "2026-11-10T16:17:25.186Z",
    "finishedAt": "2026-11-10T16:17:33.912Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 8659,
      "runTimeSecs": 8.659,
      "computeUnits": 0.009621111111111112,
      "imageSizeBytes": 319217152
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Brazilian CNPJ Lookup Input\",\n  \"description\": \"Look up Brazilian companies by CNPJ in bulk, or discover companies by CNAE, state, city, legal nature or partner. Returns official Receita Federal registry data and full partner (QSA) records.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"lookup\",\n        \"discovery\"\n      ],\n      \"enumTitles\": [\n        \"Look up CNPJs\",\n        \"Find companies by filters\"\n      ],\n      \"default\": \"lookup\",\n      \"prefill\": \"lookup\",\n      \"description\": \"Look up a list of CNPJs, or discover companies that match filters.\"\n    },\n    \"cnpjs\": {\n      \"title\": \"CNPJ numbers\",\n      \"type\": \"array\",\n      \"editor\": \"json\",\n      \"description\": \"CNPJ numbers to look up (mode=lookup). Numeric or alphanumeric, formatted or plain. Example: [\\\"18.236.120/0001-58\\\", \\\"00000000E08G12\\\"].\",\n      \"prefill\": [\n        \"18236120000158\"\n      ]\n    },\n    \"cnpjText\": {\n      \"title\": \"CNPJ list or CSV text\",\n      \"type\": \"string\",\n      \"editor\": \"textarea\",\n      \"description\": \"Paste a CSV or any text containing CNPJs (mode=lookup). Every valid CNPJ is extracted, validated and deduplicated. A spreadsheet column with or without a header works.\"\n    },\n    \"cnaes\": {\n      \"title\": \"CNAE codes\",\n      \"type\": \"array\",\n      \"editor\": \"stringList\",\n      \"description\": \"One or more 7-digit CNAE codes (mode=discovery). Matches primary or secondary activity. Example: [\\\"6209100\\\", \\\"6201501\\\"].\"\n    },\n    \"uf\": {\n      \"title\": \"State\",\n      \"type\": \"string\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"ALL\",\n        \"AC\",\n        \"AL\",\n        \"AP\",\n        \"AM\",\n        \"BA\",\n        \"CE\",\n        \"DF\",\n        \"ES\",\n        \"GO\",\n        \"MA\",\n        \"MT\",\n        \"MS\",\n        \"MG\",\n        \"PA\",\n        \"PB\",\n        \"PR\",\n        \"PE\",\n        \"PI\",\n        \"RJ\",\n        \"RN\",\n        \"RS\",\n        \"RO\",\n        \"RR\",\n        \"SC\",\n        \"SP\",\n        \"SE\",\n        \"TO\"\n      ],\n      \"enumTitles\": [\n        \"All states\",\n        \"Acre\",\n        \"Alagoas\",\n        \"Amapá\",\n        \"Amazonas\",\n        \"Bahia\",\n        \"Ceará\",\n        \"Distrito Federal\",\n        \"Espírito Santo\",\n        \"Goiás\",\n        \"Maranhão\",\n        \"Mato Grosso\",\n        \"Mato Grosso do Sul\",\n        \"Minas Gerais\",\n        \"Pará\",\n        \"Paraíba\",\n        \"Paraná\",\n        \"Pernambuco\",\n        \"Piauí\",\n        \"Rio de Janeiro\",\n        \"Rio Grande do Norte\",\n        \"Rio Grande do Sul\",\n        \"Rondônia\",\n        \"Roraima\",\n        \"Santa Catarina\",\n        \"São Paulo\",\n        \"Sergipe\",\n        \"Tocantins\"\n      ],\n      \"default\": \"ALL\",\n      \"prefill\": \"ALL\",\n      \"description\": \"Brazilian state to narrow discovery (mode=discovery).\"\n    },\n    \"municipio\": {\n      \"title\": \"Municipality code\",\n      \"type\": \"string\",\n      \"editor\": \"textfield\",\n      \"description\": \"IBGE or SIAFI municipality code, digits only (mode=discovery). Example: 3550308 (São Paulo), 5300108 (Brasília). This is a code, not a city name.\"\n    },\n    \"naturezaJuridica\": {\n      \"title\": \"Legal nature code\",\n      \"type\": \"string\",\n      \"editor\": \"textfield\",\n      \"description\": \"4-digit legal-nature code (mode=discovery). Example: 2135 (Empresário Individual), 2062 (Sociedade Empresária Limitada).\"\n    },\n    \"partnerCpf\": {\n      \"title\": \"Partner CPF/CNPJ\",\n      \"type\": \"string\",\n      \"editor\": \"textfield\",\n      \"description\": \"Masked partner document from the QSA (mode=discovery), in the Receita format such as ***123456**. Add a state or CNAE to narrow the search; the same mask can match different people.\"\n    },\n    \"situacao\": {\n      \"title\": \"Registration status\",\n      \"type\": \"string\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"ATIVA\",\n        \"SUSPENSA\",\n        \"INAPTA\",\n        \"BAIXADA\",\n        \"NULA\"\n      ],\n      \"enumTitles\": [\n        \"All statuses\",\n        \"Active\",\n        \"Suspended\",\n        \"Inactive\",\n        \"Closed\",\n        \"Null\"\n      ],\n      \"default\": \"ATIVA\",\n      \"prefill\": \"ATIVA\",\n      \"description\": \"Keep only companies with this registration status (mode=discovery).\"\n    },\n    \"includePartners\": {\n      \"title\": \"Include partners (QSA)\",\n      \"type\": \"boolean\",\n      \"description\": \"Include the full partner/shareholder list.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"includeSecondaryActivities\": {\n      \"title\": \"Include secondary CNAEs\",\n      \"type\": \"boolean\",\n      \"description\": \"Include the list of secondary CNAE activities.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"maxItems\": {\n      \"title\": \"Maximum records\",\n      \"type\": \"integer\",\n      \"editor\": \"number\",\n      \"minimum\": 1,\n      \"maximum\": 100000,\n      \"default\": 1000,\n      \"prefill\": 1,\n      \"description\": \"Maximum CNPJs to process in lookup, or maximum records to emit in discovery.\"\n    }\n  }\n}",
    "readme": "# Brazilian CNPJ Bulk Lookup & Partner Records Scraper\n\nLook up Brazilian companies by CNPJ in bulk, or discover companies by CNAE activity, state, city, legal nature or partner. Every result is an official-style Receita Federal registry record: legal name, status, CNAE codes, address, Simples/MEI flags, tax history, capital, and the full partner (QSA) list. Numeric and 2026 alphanumeric CNPJs are accepted, with no login, API key, or proxy.\n\n## What this actor does\n\n- **Bulk lookup:** paste a list, a spreadsheet column, or CSV text. CNPJs are normalized, check-digit validated, deduplicated, and resolved in one run.\n- **Discovery:** find companies by CNAE (primary or secondary), state, municipality code, legal nature, or a partner's masked CPF/CNPJ, then keep only the status you want.\n- **Full partner records:** name, masked document, person/company/foreign type, qualification, entry date, age band, country and legal representative.\n- **Tax and status depth:** Simples Nacional, MEI, option/exclusion dates, per-year tax regime, status reason, special status and registration dates.\n- **Clean output:** empty fields are omitted at every level; `false` and `0` are kept because they are real values.\n\n## Output per company\n\n| Field | Description |\n|---|---|\n| `cnpj`, `cnpjFormatado`, `cnpjRaiz` | 14-character CNPJ, formatted mask, and 8-character root |\n| `razaoSocial`, `nomeFantasia` | Legal name and trade name |\n| `isMatriz`, `tipoUnidade` | Headquarters or branch |\n| `situacaoCadastral`, `situacaoCadastralCodigo` | Registration status and code |\n| `situacaoCadastralMotivo`, `situacaoCadastralMotivoCodigo` | Reason for the current status |\n| `dataSituacaoCadastral` | Date the status took effect (`YYYY-MM-DD`) |\n| `situacaoEspecial`, `dataSituacaoEspecial` | Special registration status, when published |\n| `cnaeFiscal`, `cnaeDescricao` | Primary CNAE code and description |\n| `cnaesSecundarios` | Secondary CNAEs, each `{codigo, descricao}` |\n| `naturezaJuridica`, `naturezaJuridicaCodigo` | Legal nature description and code |\n| `capitalSocial` | Share capital in BRL (zero is kept) |\n| `porte`, `porteCodigo` | Company size and code |\n| `optanteSimples`, `dataOpcaoSimples`, `dataExclusaoSimples` | Simples Nacional flag and dates |\n| `optanteMei`, `dataOpcaoMei`, `dataExclusaoMei` | MEI flag and dates |\n| `regimeTributario`, `regimeTributarioAno`, `regimeTributarioHistorico` | Latest tax regime, its year, and the full per-year history |\n| `endereco` | `{tipoLogradouro, logradouro, numero, complemento, bairro, municipio, codigoMunicipioIbge, uf, cep, pais, codigoPais, nomeCidadeExterior}` |\n| `municipio`, `uf`, `cep` | Top-level address fields for spreadsheets |\n| `telefone1`, `telefone2`, `fax`, `email` | Contact data when the registry publishes it |\n| `socios` | Partner list: `{nome, documento, tipo, qualificacao, codigoQualificacao, dataEntradaSociedade, faixaEtaria, codigoFaixaEtaria, pais, codigoPais, representanteLegal}` |\n| `companyAgeDays`, `statusAgeDays` | Days since activity start and since the current status |\n| `source`, `sourceUrl`, `sourceUpdatedAt` | Data source, provider URL used (company endpoint for lookups, search query for discovery), and registry snapshot month |\n| `recordType`, `scrapedAt` | Always `company`; ISO UTC scrape time |\n\n**Fallback depth.** If the primary mirror and its same-schema fallback are unavailable, the independent fallback may omit the per-year tax regime and some partner detail (masked document, partner type, entry date, legal representative). Unavailable fields are omitted, never fabricated; `source` identifies the mirror that answered.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `lookup` | `lookup` or `discovery` |\n| `cnpjs` | array | – | CNPJ numbers for lookup, numeric or alphanumeric, formatted or plain |\n| `cnpjText` | string | – | CSV or free text containing CNPJs; valid values are extracted and deduplicated |\n| `cnaes` | array | – | 7-digit CNAE codes for discovery (primary or secondary) |\n| `uf` | string | `ALL` | State for discovery |\n| `municipio` | string | – | IBGE/SIAFI municipality code (digits, not a city name) |\n| `naturezaJuridica` | string | – | 4-digit legal-nature code |\n| `partnerCpf` | string | – | Masked partner CPF/CNPJ, e.g. `***123456**` |\n| `situacao` | string | `ATIVA` | `all`, `ATIVA`, `SUSPENSA`, `INAPTA`, `BAIXADA`, `NULA` |\n| `includePartners` | boolean | `true` | Include the QSA list |\n| `includeSecondaryActivities` | boolean | `true` | Include secondary CNAEs |\n| `maxItems` | integer | `1000` | Max CNPJs processed in lookup or records emitted in discovery (1–100,000) |\n\n### Example: bulk lookup with partners\n\n```json\n{\n  \"mode\": \"lookup\",\n  \"cnpjs\": [\"18.236.120/0001-58\", \"00000000E08G12\", \"33.000.167/0001-01\"],\n  \"includePartners\": true,\n  \"includeSecondaryActivities\": true\n}\n```\n\n### Example: paste a spreadsheet column\n\n```json\n{\n  \"mode\": \"lookup\",\n  \"cnpjText\": \"cliente,cnpj\\nNubank,18.236.120/0001-58\\nBanco do Brasil,00.000.000/E08G-12\",\n  \"maxItems\": 500\n}\n```\n\n### Example: discover active companies by CNAE and city\n\n```json\n{\n  \"mode\": \"discovery\",\n  \"cnaes\": [\"4713004\", \"6209100\"],\n  \"uf\": \"SP\",\n  \"municipio\": \"3550308\",\n  \"situacao\": \"ATIVA\",\n  \"maxItems\": 100\n}\n```\n\n### Example: find companies by a partner's masked CPF\n\n```json\n{\n  \"mode\": \"discovery\",\n  \"partnerCpf\": \"***550179**\",\n  \"uf\": \"RR\",\n  \"situacao\": \"all\",\n  \"maxItems\": 20\n}\n```\n\n## Use cases\n\n- **KYB and vendor onboarding:** confirm a Brazilian counterparty's status, legal nature, capital and owners before signing.\n- **Bulk CRM enrichment:** turn a CNPJ column into industry, address, contact and ownership data.\n- **Compliance screening:** review status reason, Simples/MEI and partner structure for risk triage.\n- **B2B prospecting:** build lists by CNAE, state and municipality, then filter to active companies.\n- **Ownership research:** trace a masked partner across companies or review a company's QSA.\n- **Market mapping:** count companies in an activity or region before outreach.\n\n## FAQ\n\n**What is a CNPJ?**\n*Cadastro Nacional da Pessoa Jurídica* — Brazil's 14-character company registration number issued by the Receita Federal. Since July 2026 new registrations can include letters (alphanumeric CNPJ), and this actor accepts both formats.\n\n**Where does the data come from?**\nPublic mirrors of the official Receita Federal CNPJ registry. The registry is published monthly, so very recent changes may not appear immediately.\n\n**Do I need an API key, login, cookie or proxy?**\nNo. The actor gets real data without credentials and without any proxy setup. Just fill in the input and run it.\n\n**What happens to invalid or unknown CNPJs?**\nInvalid CNPJs are skipped before any request; unknown CNPJs are skipped by the source. The run summary reports invalid, not-found, duplicate and unavailable counts. No made-up records are ever added.\n\n**Why is the partner list (`socios`) empty for some companies?**\nMEI and individual-entrepreneur registrations normally have no QSA. The registry can also withhold a QSA in specific legal cases. The field is simply omitted rather than filled with placeholders.\n\n**Why is `email` often missing?**\nThe public CNPJ registry rarely publishes company email addresses. When the source has one, it is included; otherwise the field is omitted. Phone and address data are more consistently available.\n\n**Does `socios` include equity percentages?**\nNo. The public registry exposes the partner list, qualification, entry date, age band and masked document, but not each partner's percentage. Percentages are only in the company's contract at the Junta Comercial.\n\n**Can I search by a partner's CPF?**\nYes, using the masked format shown in the QSA (for example `***123456**`). Add a state or CNAE because the same six visible digits can match more than one person.\n\n**Is this affiliated with the Receita Federal or the Brazilian government?**\nNo. This is an independent, third-party actor that reads public registry mirrors and is not operated by or affiliated with any government agency.\n\n## Use it as an API (server mode)\n\nNeed one answer right away instead of a batch job? Send the input as an HTTP request and the results come back in the response. There's no run to start and poll.\n\n```bash\ncurl -H \"Authorization: Bearer $APIFY_TOKEN\" \\\n  \"https://dataspryva--brazilian-cnpj-bulk-lookup-and-partner-records.apify.actor/?mode=lookup&cnpjs=18236120000158\"\n```\n\nOr POST the same input as JSON:\n\n```bash\ncurl -X POST -H \"Authorization: Bearer $APIFY_TOKEN\" -H \"Content-Type: application/json\" \\\n  -d '{\"mode\": \"lookup\", \"cnpjs\": [\"18236120000158\"]}' \\\n  \"https://dataspryva--brazilian-cnpj-bulk-lookup-and-partner-records.apify.actor/\"\n```\n\n- The fields are the same as in the input above. With GET, repeat a parameter once for each value in a list.\n- You get back a JSON array with the same records a normal run saves. They're saved to the run's dataset too.\n- Each request is capped at 20 results and 4 minutes. For bigger jobs, start a normal run.\n- The request runs in your own Apify account at the Actor's normal price (a start fee plus a price per result). The server shuts down after a minute with no requests.\n- The Server tab on this page lists every parameter and lets you try a request from your browser.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "brazilian-cnpj-bulk-lookup-and-partner-records",
      "title": "Brazilian CNPJ Bulk Lookup & Partner Records Scraper",
      "description": "Look up Brazilian CNPJs in bulk or discover companies by CNAE, state, and city. Get official Receita Federal records: legal name, status, CNAE codes, address, Simples/MEI flags, tax regime, capital, and full partner (QSA) details.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Brazilian CNPJ Bulk Lookup & Partner Records Scraper\n\nLook up Brazilian companies by CNPJ in bulk, or discover companies by CNAE activity, state, city, legal nature or partner. Every result is an official-style Receita Federal registry record: legal name, status, CNAE codes, address, Simples/MEI flags, tax history, capital, and the full partner (QSA) list. Numeric and 2026 alphanumeric CNPJs are accepted, with no login, API key, or proxy.\n\n## What this actor does\n\n- **Bulk lookup:** paste a list, a spreadsheet column, or CSV text. CNPJs are normalized, check-digit validated, deduplicated, and resolved in one run.\n- **Discovery:** find companies by CNAE (primary or secondary), state, municipality code, legal nature, or a partner's masked CPF/CNPJ, then keep only the status you want.\n- **Full partner records:** name, masked document, person/company/foreign type, qualification, entry date, age band, country and legal representative.\n- **Tax and status depth:** Simples Nacional, MEI, option/exclusion dates, per-year tax regime, status reason, special status and registration dates.\n- **Clean output:** empty fields are omitted at every level; `false` and `0` are kept because they are real values.\n\n## Output per company\n\n| Field | Description |\n|---|---|\n| `cnpj`, `cnpjFormatado`, `cnpjRaiz` | 14-character CNPJ, formatted mask, and 8-character root |\n| `razaoSocial`, `nomeFantasia` | Legal name and trade name |\n| `isMatriz`, `tipoUnidade` | Headquarters or branch |\n| `situacaoCadastral`, `situacaoCadastralCodigo` | Registration status and code |\n| `situacaoCadastralMotivo`, `situacaoCadastralMotivoCodigo` | Reason for the current status |\n| `dataSituacaoCadastral` | Date the status took effect (`YYYY-MM-DD`) |\n| `situacaoEspecial`, `dataSituacaoEspecial` | Special registration status, when published |\n| `cnaeFiscal`, `cnaeDescricao` | Primary CNAE code and description |\n| `cnaesSecundarios` | Secondary CNAEs, each `{codigo, descricao}` |\n| `naturezaJuridica`, `naturezaJuridicaCodigo` | Legal nature description and code |\n| `capitalSocial` | Share capital in BRL (zero is kept) |\n| `porte`, `porteCodigo` | Company size and code |\n| `optanteSimples`, `dataOpcaoSimples`, `dataExclusaoSimples` | Simples Nacional flag and dates |\n| `optanteMei`, `dataOpcaoMei`, `dataExclusaoMei` | MEI flag and dates |\n| `regimeTributario`, `regimeTributarioAno`, `regimeTributarioHistorico` | Latest tax regime, its year, and the full per-year history |\n| `endereco` | `{tipoLogradouro, logradouro, numero, complemento, bairro, municipio, codigoMunicipioIbge, uf, cep, pais, codigoPais, nomeCidadeExterior}` |\n| `municipio`, `uf`, `cep` | Top-level address fields for spreadsheets |\n| `telefone1`, `telefone2`, `fax`, `email` | Contact data when the registry publishes it |\n| `socios` | Partner list: `{nome, documento, tipo, qualificacao, codigoQualificacao, dataEntradaSociedade, faixaEtaria, codigoFaixaEtaria, pais, codigoPais, representanteLegal}` |\n| `companyAgeDays`, `statusAgeDays` | Days since activity start and since the current status |\n| `source`, `sourceUrl`, `sourceUpdatedAt` | Data source, provider URL used (company endpoint for lookups, search query for discovery), and registry snapshot month |\n| `recordType`, `scrapedAt` | Always `company`; ISO UTC scrape time |\n\n**Fallback depth.** If the primary mirror and its same-schema fallback are unavailable, the independent fallback may omit the per-year tax regime and some partner detail (masked document, partner type, entry date, legal representative). Unavailable fields are omitted, never fabricated; `source` identifies the mirror that answered.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `lookup` | `lookup` or `discovery` |\n| `cnpjs` | array | – | CNPJ numbers for lookup, numeric or alphanumeric, formatted or plain |\n| `cnpjText` | string | – | CSV or free text containing CNPJs; valid values are extracted and deduplicated |\n| `cnaes` | array | – | 7-digit CNAE codes for discovery (primary or secondary) |\n| `uf` | string | `ALL` | State for discovery |\n| `municipio` | string | – | IBGE/SIAFI municipality code (digits, not a city name) |\n| `naturezaJuridica` | string | – | 4-digit legal-nature code |\n| `partnerCpf` | string | – | Masked partner CPF/CNPJ, e.g. `***123456**` |\n| `situacao` | string | `ATIVA` | `all`, `ATIVA`, `SUSPENSA`, `INAPTA`, `BAIXADA`, `NULA` |\n| `includePartners` | boolean | `true` | Include the QSA list |\n| `includeSecondaryActivities` | boolean | `true` | Include secondary CNAEs |\n| `maxItems` | integer | `1000` | Max CNPJs processed in lookup or records emitted in discovery (1–100,000) |\n\n### Example: bulk lookup with partners\n\n```json\n{\n  \"mode\": \"lookup\",\n  \"cnpjs\": [\"18.236.120/0001-58\", \"00000000E08G12\", \"33.000.167/0001-01\"],\n  \"includePartners\": true,\n  \"includeSecondaryActivities\": true\n}\n```\n\n### Example: paste a spreadsheet column\n\n```json\n{\n  \"mode\": \"lookup\",\n  \"cnpjText\": \"cliente,cnpj\\nNubank,18.236.120/0001-58\\nBanco do Brasil,00.000.000/E08G-12\",\n  \"maxItems\": 500\n}\n```\n\n### Example: discover active companies by CNAE and city\n\n```json\n{\n  \"mode\": \"discovery\",\n  \"cnaes\": [\"4713004\", \"6209100\"],\n  \"uf\": \"SP\",\n  \"municipio\": \"3550308\",\n  \"situacao\": \"ATIVA\",\n  \"maxItems\": 100\n}\n```\n\n### Example: find companies by a partner's masked CPF\n\n```json\n{\n  \"mode\": \"discovery\",\n  \"partnerCpf\": \"***550179**\",\n  \"uf\": \"RR\",\n  \"situacao\": \"all\",\n  \"maxItems\": 20\n}\n```\n\n## Use cases\n\n- **KYB and vendor onboarding:** confirm a Brazilian counterparty's status, legal nature, capital and owners before signing.\n- **Bulk CRM enrichment:** turn a CNPJ column into industry, address, contact and ownership data.\n- **Compliance screening:** review status reason, Simples/MEI and partner structure for risk triage.\n- **B2B prospecting:** build lists by CNAE, state and municipality, then filter to active companies.\n- **Ownership research:** trace a masked partner across companies or review a company's QSA.\n- **Market mapping:** count companies in an activity or region before outreach.\n\n## FAQ\n\n**What is a CNPJ?**\n*Cadastro Nacional da Pessoa Jurídica* — Brazil's 14-character company registration number issued by the Receita Federal. Since July 2026 new registrations can include letters (alphanumeric CNPJ), and this actor accepts both formats.\n\n**Where does the data come from?**\nPublic mirrors of the official Receita Federal CNPJ registry. The registry is published monthly, so very recent changes may not appear immediately.\n\n**Do I need an API key, login, cookie or proxy?**\nNo. The actor gets real data without credentials and without any proxy setup. Just fill in the input and run it.\n\n**What happens to invalid or unknown CNPJs?**\nInvalid CNPJs are skipped before any request; unknown CNPJs are skipped by the source. The run summary reports invalid, not-found, duplicate and unavailable counts. No made-up records are ever added.\n\n**Why is the partner list (`socios`) empty for some companies?**\nMEI and individual-entrepreneur registrations normally have no QSA. The registry can also withhold a QSA in specific legal cases. The field is simply omitted rather than filled with placeholders.\n\n**Why is `email` often missing?**\nThe public CNPJ registry rarely publishes company email addresses. When the source has one, it is included; otherwise the field is omitted. Phone and address data are more consistently available.\n\n**Does `socios` include equity percentages?**\nNo. The public registry exposes the partner list, qualification, entry date, age band and masked document, but not each partner's percentage. Percentages are only in the company's contract at the Junta Comercial.\n\n**Can I search by a partner's CPF?**\nYes, using the masked format shown in the QSA (for example `***123456**`). Add a state or CNAE because the same six visible digits can match more than one person.\n\n**Is this affiliated with the Receita Federal or the Brazilian government?**\nNo. This is an independent, third-party actor that reads public registry mirrors and is not operated by or affiliated with any government agency.\n\n## Use it as an API (server mode)\n\nNeed one answer right away instead of a batch job? Send the input as an HTTP request and the results come back in the response. There's no run to start and poll.\n\n```bash\ncurl -H \"Authorization: Bearer $APIFY_TOKEN\" \\\n  \"https://dataspryva--brazilian-cnpj-bulk-lookup-and-partner-records.apify.actor/?mode=lookup&cnpjs=18236120000158\"\n```\n\nOr POST the same input as JSON:\n\n```bash\ncurl -X POST -H \"Authorization: Bearer $APIFY_TOKEN\" -H \"Content-Type: application/json\" \\\n  -d '{\"mode\": \"lookup\", \"cnpjs\": [\"18236120000158\"]}' \\\n  \"https://dataspryva--brazilian-cnpj-bulk-lookup-and-partner-records.apify.actor/\"\n```\n\n- The fields are the same as in the input above. With GET, repeat a parameter once for each value in a list.\n- You get back a JSON array with the same records a normal run saves. They're saved to the run's dataset too.\n- Each request is capped at 20 results and 4 minutes. For bigger jobs, start a normal run.\n- The request runs in your own Apify account at the Actor's normal price (a start fee plus a price per result). The server shuts down after a minute with no requests.\n- The Server tab on this page lists every parameter and lets you try a request from your browser.\n",
      "input": {
        "title": "Brazilian CNPJ Lookup Input",
        "description": "Look up Brazilian companies by CNPJ in bulk, or discover companies by CNAE, state, city, legal nature or partner. Returns official Receita Federal registry data and full partner (QSA) records.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "editor": "select",
            "enum": [
              "lookup",
              "discovery"
            ],
            "enumTitles": [
              "Look up CNPJs",
              "Find companies by filters"
            ],
            "default": "lookup",
            "prefill": "lookup",
            "description": "Look up a list of CNPJs, or discover companies that match filters."
          },
          "cnpjs": {
            "title": "CNPJ numbers",
            "type": "array",
            "editor": "json",
            "description": "CNPJ numbers to look up (mode=lookup). Numeric or alphanumeric, formatted or plain. Example: [\"18.236.120/0001-58\", \"00000000E08G12\"].",
            "prefill": [
              "18236120000158"
            ]
          },
          "cnpjText": {
            "title": "CNPJ list or CSV text",
            "type": "string",
            "editor": "textarea",
            "description": "Paste a CSV or any text containing CNPJs (mode=lookup). Every valid CNPJ is extracted, validated and deduplicated. A spreadsheet column with or without a header works."
          },
          "cnaes": {
            "title": "CNAE codes",
            "type": "array",
            "editor": "stringList",
            "description": "One or more 7-digit CNAE codes (mode=discovery). Matches primary or secondary activity. Example: [\"6209100\", \"6201501\"]."
          },
          "uf": {
            "title": "State",
            "type": "string",
            "editor": "select",
            "enum": [
              "ALL",
              "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"
            ],
            "enumTitles": [
              "All states",
              "Acre",
              "Alagoas",
              "Amapá",
              "Amazonas",
              "Bahia",
              "Ceará",
              "Distrito Federal",
              "Espírito Santo",
              "Goiás",
              "Maranhão",
              "Mato Grosso",
              "Mato Grosso do Sul",
              "Minas Gerais",
              "Pará",
              "Paraíba",
              "Paraná",
              "Pernambuco",
              "Piauí",
              "Rio de Janeiro",
              "Rio Grande do Norte",
              "Rio Grande do Sul",
              "Rondônia",
              "Roraima",
              "Santa Catarina",
              "São Paulo",
              "Sergipe",
              "Tocantins"
            ],
            "default": "ALL",
            "prefill": "ALL",
            "description": "Brazilian state to narrow discovery (mode=discovery)."
          },
          "municipio": {
            "title": "Municipality code",
            "type": "string",
            "editor": "textfield",
            "description": "IBGE or SIAFI municipality code, digits only (mode=discovery). Example: 3550308 (São Paulo), 5300108 (Brasília). This is a code, not a city name."
          },
          "naturezaJuridica": {
            "title": "Legal nature code",
            "type": "string",
            "editor": "textfield",
            "description": "4-digit legal-nature code (mode=discovery). Example: 2135 (Empresário Individual), 2062 (Sociedade Empresária Limitada)."
          },
          "partnerCpf": {
            "title": "Partner CPF/CNPJ",
            "type": "string",
            "editor": "textfield",
            "description": "Masked partner document from the QSA (mode=discovery), in the Receita format such as ***123456**. Add a state or CNAE to narrow the search; the same mask can match different people."
          },
          "situacao": {
            "title": "Registration status",
            "type": "string",
            "editor": "select",
            "enum": [
              "all",
              "ATIVA",
              "SUSPENSA",
              "INAPTA",
              "BAIXADA",
              "NULA"
            ],
            "enumTitles": [
              "All statuses",
              "Active",
              "Suspended",
              "Inactive",
              "Closed",
              "Null"
            ],
            "default": "ATIVA",
            "prefill": "ATIVA",
            "description": "Keep only companies with this registration status (mode=discovery)."
          },
          "includePartners": {
            "title": "Include partners (QSA)",
            "type": "boolean",
            "description": "Include the full partner/shareholder list.",
            "default": true,
            "prefill": true
          },
          "includeSecondaryActivities": {
            "title": "Include secondary CNAEs",
            "type": "boolean",
            "description": "Include the list of secondary CNAE activities.",
            "default": true,
            "prefill": true
          },
          "maxItems": {
            "title": "Maximum records",
            "type": "integer",
            "editor": "number",
            "minimum": 1,
            "maximum": 100000,
            "default": 1000,
            "prefill": 1,
            "description": "Maximum CNPJs to process in lookup, or maximum records to emit in discovery."
          }
        }
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Brazilian CNPJ Bulk Lookup & Partner Records Scraper Output",
        "description": "One record per Brazilian company, with Receita Federal status, CNAE activities, address, Simples/MEI, tax history and full partner (QSA) records.",
        "properties": {
          "companies": {
            "type": "string",
            "title": "Company records",
            "description": "Dataset containing all resolved Brazilian company records.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Companies",
              "transformation": {
                "fields": [
                  "cnpj",
                  "razaoSocial",
                  "nomeFantasia",
                  "situacaoCadastral",
                  "cnaeDescricao",
                  "municipio",
                  "uf",
                  "dataInicioAtividade",
                  "isMatriz",
                  "optanteMei",
                  "source"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {},
      "webServerSchema": {
        "openapi": "3.0.3",
        "info": {
          "title": "Brazilian CNPJ Bulk Lookup & Partner Records Scraper (server mode)",
          "version": "1.1",
          "description": "Send one lookup and get the results back in the response. It takes the same input as a normal run: query parameters with GET, or a JSON body with POST. At most 20 results and 240 seconds per request; start a normal run for bigger jobs. Requests run in your own Apify account at the Actor's normal price.",
          "x-oa-server-mode": "1.1"
        },
        "paths": {
          "/": {
            "get": {
              "operationId": "lookupGet",
              "summary": "Run one lookup (query parameters)",
              "parameters": [
                {
                  "name": "mode",
                  "in": "query",
                  "required": false,
                  "description": "Look up a list of CNPJs, or discover companies that match filters.",
                  "schema": {
                    "type": "string",
                    "enum": [
                      "lookup",
                      "discovery"
                    ],
                    "default": "lookup"
                  },
                  "example": "lookup"
                },
                {
                  "name": "cnpjs",
                  "in": "query",
                  "required": false,
                  "description": "CNPJ numbers to look up (mode=lookup). Numeric or alphanumeric, formatted or plain. Example: [\"18.236.120/0001-58\", \"00000000E08G12\"]. (GET: repeat the parameter once per value.)",
                  "schema": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 10
                  },
                  "style": "form",
                  "explode": true,
                  "example": [
                    "18236120000158"
                  ]
                },
                {
                  "name": "cnpjText",
                  "in": "query",
                  "required": false,
                  "description": "Paste a CSV or any text containing CNPJs (mode=lookup). Every valid CNPJ is extracted, validated and deduplicated. A spreadsheet column with or without a header works.",
                  "schema": {
                    "type": "string"
                  }
                },
                {
                  "name": "cnaes",
                  "in": "query",
                  "required": false,
                  "description": "One or more 7-digit CNAE codes (mode=discovery). Matches primary or secondary activity. Example: [\"6209100\", \"6201501\"]. (GET: repeat the parameter once per value.)",
                  "schema": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 5
                  },
                  "style": "form",
                  "explode": true
                },
                {
                  "name": "uf",
                  "in": "query",
                  "required": false,
                  "description": "Brazilian state to narrow discovery (mode=discovery).",
                  "schema": {
                    "type": "string",
                    "enum": [
                      "ALL",
                      "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"
                    ],
                    "default": "ALL"
                  }
                },
                {
                  "name": "municipio",
                  "in": "query",
                  "required": false,
                  "description": "IBGE or SIAFI municipality code, digits only (mode=discovery). Example: 3550308 (São Paulo), 5300108 (Brasília). This is a code, not a city name.",
                  "schema": {
                    "type": "string"
                  }
                },
                {
                  "name": "naturezaJuridica",
                  "in": "query",
                  "required": false,
                  "description": "4-digit legal-nature code (mode=discovery). Example: 2135 (Empresário Individual), 2062 (Sociedade Empresária Limitada).",
                  "schema": {
                    "type": "string"
                  }
                },
                {
                  "name": "partnerCpf",
                  "in": "query",
                  "required": false,
                  "description": "Masked partner document from the QSA (mode=discovery), in the Receita format such as ***123456**. Add a state or CNAE to narrow the search; the same mask can match different people.",
                  "schema": {
                    "type": "string"
                  }
                },
                {
                  "name": "situacao",
                  "in": "query",
                  "required": false,
                  "description": "Keep only companies with this registration status (mode=discovery).",
                  "schema": {
                    "type": "string",
                    "enum": [
                      "all",
                      "ATIVA",
                      "SUSPENSA",
                      "INAPTA",
                      "BAIXADA",
                      "NULA"
                    ],
                    "default": "ATIVA"
                  }
                },
                {
                  "name": "includePartners",
                  "in": "query",
                  "required": false,
                  "description": "Include the full partner/shareholder list.",
                  "schema": {
                    "type": "boolean",
                    "default": true
                  }
                },
                {
                  "name": "includeSecondaryActivities",
                  "in": "query",
                  "required": false,
                  "description": "Include the list of secondary CNAE activities.",
                  "schema": {
                    "type": "boolean",
                    "default": true
                  }
                },
                {
                  "name": "maxItems",
                  "in": "query",
                  "required": false,
                  "description": "Maximum CNPJs to process in lookup, or maximum records to emit in discovery.",
                  "schema": {
                    "type": "integer",
                    "default": 20,
                    "minimum": 1,
                    "maximum": 20
                  }
                }
              ],
              "responses": {
                "200": {
                  "description": "The results as a JSON array (at most 20). They are also saved to the run's dataset and billed per result, like a normal run.",
                  "headers": {
                    "X-Item-Count": {
                      "schema": {
                        "type": "integer"
                      },
                      "description": "Results returned."
                    },
                    "X-Status-Message": {
                      "schema": {
                        "type": "string"
                      },
                      "description": "The Actor's last status message, e.g. why nothing was found."
                    }
                  },
                  "content": {
                    "application/json": {
                      "schema": {
                        "type": "array",
                        "items": {
                          "$ref": "#/components/schemas/Item"
                        }
                      },
                      "example": [
                        {
                          "cnpj": "18236120000158",
                          "cnpjFormatado": "18.236.120/0001-58",
                          "cnpjRaiz": "18236120",
                          "isMatriz": true,
                          "tipoUnidade": "Matriz",
                          "razaoSocial": "NU PAGAMENTOS S.A. - INSTITUICAO DE PAGAMENTO",
                          "situacaoCadastralCodigo": 2,
                          "situacaoCadastral": "Ativa",
                          "dataSituacaoCadastral": "2013-06-04",
                          "situacaoCadastralMotivo": "SEM MOTIVO",
                          "situacaoCadastralMotivoCodigo": 0,
                          "naturezaJuridica": "Sociedade Anônima Fechada",
                          "naturezaJuridicaCodigo": 2054,
                          "capitalSocial": 10872130000,
                          "porteCodigo": 5,
                          "porte": "Demais",
                          "cnaeFiscal": 6619399,
                          "cnaeDescricao": "Outras atividades auxiliares dos serviços financeiros não especificadas anteriormente",
                          "cnaesSecundarios": [
                            {
                              "codigo": 5913800,
                              "descricao": "Distribuição cinematográfica, de vídeo e de programas de televisão"
                            },
                            {
                              "codigo": 6204000,
                              "descricao": "Consultoria em tecnologia da informação"
                            },
                            {
                              "codigo": 6209100,
                              "descricao": "Suporte técnico, manutenção e outros serviços em tecnologia da informação"
                            }
                          ],
                          "endereco": {
                            "tipoLogradouro": "RUA",
                            "logradouro": "RUA CAPOTE VALENTE",
                            "numero": "120",
                            "complemento": "ANDAR 01 AO 8 E 9 ANDAR CONJ 902 E 16 ANDAR",
                            "bairro": "PINHEIROS",
                            "municipio": "SAO PAULO",
                            "codigoMunicipioIbge": 3550308,
                            "uf": "SP",
                            "cep": "05409000"
                          },
                          "municipio": "SAO PAULO",
                          "uf": "SP",
                          "cep": "05409000",
                          "telefone1": "1122222222",
                          "fax": "1120390556",
                          "regimeTributario": "LUCRO REAL",
                          "regimeTributarioAno": 2024,
                          "regimeTributarioHistorico": [
                            {
                              "ano": 2016,
                              "regime": "LUCRO REAL",
                              "escrituracoes": 1
                            },
                            {
                              "ano": 2017,
                              "regime": "LUCRO REAL",
                              "escrituracoes": 1
                            },
                            {
                              "ano": 2018,
                              "regime": "LUCRO REAL",
                              "escrituracoes": 1
                            }
                          ],
                          "dataInicioAtividade": "2013-06-04",
                          "companyAgeDays": 4907,
                          "statusAgeDays": 4907,
                          "socios": [
                            {
                              "nome": "ARTHUR FERREIRA VALADAO",
                              "documento": "***897248**",
                              "tipo": "Pessoa Física",
                              "qualificacao": "Diretor",
                              "codigoQualificacao": 10,
                              "dataEntradaSociedade": "2021-08-03",
                              "faixaEtaria": "Entre 31 a 40 anos",
                              "codigoFaixaEtaria": 4
                            },
                            {
                              "nome": "BRUNO GUSMAO ROCHA",
                              "documento": "***948396**",
                              "tipo": "Pessoa Física",
                              "qualificacao": "Diretor",
                              "codigoQualificacao": 10,
                              "dataEntradaSociedade": "2025-12-22",
                              "faixaEtaria": "Entre 41 a 50 anos",
                              "codigoFaixaEtaria": 5
                            },
                            {
                              "nome": "CLAUDIO DE NARDI QUEIROZ",
                              "documento": "***313948**",
                              "tipo": "Pessoa Física",
                              "qualificacao": "Diretor",
                              "codigoQualificacao": 10,
                              "dataEntradaSociedade": "2026-05-08",
                              "faixaEtaria": "Entre 41 a 50 anos",
                              "codigoFaixaEtaria": 5
                            }
                          ],
                          "recordType": "company",
                          "source": "minhareceita",
                          "sourceUrl": "https://minhareceita.org/18236120000158",
                          "sourceUpdatedAt": "2026-10",
                          "scrapedAt": "2026-11-10T15:34:40+00:00"
                        }
                      ]
                    }
                  }
                },
                "400": {
                  "description": "Invalid, missing or unknown input fields. Nothing ran.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "$ref": "#/components/schemas/Error"
                      },
                      "example": {
                        "error": "invalid_input",
                        "errorDescription": "mode: required"
                      }
                    }
                  }
                },
                "422": {
                  "description": "The Actor could not complete this request (for example, nothing matches). No results were delivered.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "$ref": "#/components/schemas/Error"
                      }
                    }
                  }
                },
                "500": {
                  "description": "Unexpected failure. Safe to retry.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "$ref": "#/components/schemas/Error"
                      }
                    }
                  }
                },
                "504": {
                  "description": "The request used up its 240 s budget. The results found so far are in partialItems.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "allOf": [
                          {
                            "$ref": "#/components/schemas/Error"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "partialItems": {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Item"
                                }
                              }
                            }
                          }
                        ]
                      }
                    }
                  }
                }
              }
            },
            "post": {
              "operationId": "lookupPost",
              "summary": "Run one lookup (JSON body)",
              "requestBody": {
                "required": true,
                "content": {
                  "application/json": {
                    "schema": {
                      "type": "object",
                      "properties": {
                        "mode": {
                          "type": "string",
                          "enum": [
                            "lookup",
                            "discovery"
                          ],
                          "default": "lookup",
                          "description": "Look up a list of CNPJs, or discover companies that match filters."
                        },
                        "cnpjs": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 10,
                          "description": "CNPJ numbers to look up (mode=lookup). Numeric or alphanumeric, formatted or plain. Example: [\"18.236.120/0001-58\", \"00000000E08G12\"]."
                        },
                        "cnpjText": {
                          "type": "string",
                          "description": "Paste a CSV or any text containing CNPJs (mode=lookup). Every valid CNPJ is extracted, validated and deduplicated. A spreadsheet column with or without a header works."
                        },
                        "cnaes": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 5,
                          "description": "One or more 7-digit CNAE codes (mode=discovery). Matches primary or secondary activity. Example: [\"6209100\", \"6201501\"]."
                        },
                        "uf": {
                          "type": "string",
                          "enum": [
                            "ALL",
                            "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"
                          ],
                          "default": "ALL",
                          "description": "Brazilian state to narrow discovery (mode=discovery)."
                        },
                        "municipio": {
                          "type": "string",
                          "description": "IBGE or SIAFI municipality code, digits only (mode=discovery). Example: 3550308 (São Paulo), 5300108 (Brasília). This is a code, not a city name."
                        },
                        "naturezaJuridica": {
                          "type": "string",
                          "description": "4-digit legal-nature code (mode=discovery). Example: 2135 (Empresário Individual), 2062 (Sociedade Empresária Limitada)."
                        },
                        "partnerCpf": {
                          "type": "string",
                          "description": "Masked partner document from the QSA (mode=discovery), in the Receita format such as ***123456**. Add a state or CNAE to narrow the search; the same mask can match different people."
                        },
                        "situacao": {
                          "type": "string",
                          "enum": [
                            "all",
                            "ATIVA",
                            "SUSPENSA",
                            "INAPTA",
                            "BAIXADA",
                            "NULA"
                          ],
                          "default": "ATIVA",
                          "description": "Keep only companies with this registration status (mode=discovery)."
                        },
                        "includePartners": {
                          "type": "boolean",
                          "default": true,
                          "description": "Include the full partner/shareholder list."
                        },
                        "includeSecondaryActivities": {
                          "type": "boolean",
                          "default": true,
                          "description": "Include the list of secondary CNAE activities."
                        },
                        "maxItems": {
                          "type": "integer",
                          "default": 20,
                          "minimum": 1,
                          "maximum": 20,
                          "description": "Maximum CNPJs to process in lookup, or maximum records to emit in discovery."
                        }
                      },
                      "additionalProperties": false
                    },
                    "example": {
                      "mode": "lookup",
                      "cnpjs": [
                        "18236120000158"
                      ]
                    }
                  }
                }
              },
              "responses": {
                "200": {
                  "description": "The results as a JSON array (at most 20). They are also saved to the run's dataset and billed per result, like a normal run.",
                  "headers": {
                    "X-Item-Count": {
                      "schema": {
                        "type": "integer"
                      },
                      "description": "Results returned."
                    },
                    "X-Status-Message": {
                      "schema": {
                        "type": "string"
                      },
                      "description": "The Actor's last status message, e.g. why nothing was found."
                    }
                  },
                  "content": {
                    "application/json": {
                      "schema": {
                        "type": "array",
                        "items": {
                          "$ref": "#/components/schemas/Item"
                        }
                      },
                      "example": [
                        {
                          "cnpj": "18236120000158",
                          "cnpjFormatado": "18.236.120/0001-58",
                          "cnpjRaiz": "18236120",
                          "isMatriz": true,
                          "tipoUnidade": "Matriz",
                          "razaoSocial": "NU PAGAMENTOS S.A. - INSTITUICAO DE PAGAMENTO",
                          "situacaoCadastralCodigo": 2,
                          "situacaoCadastral": "Ativa",
                          "dataSituacaoCadastral": "2013-06-04",
                          "situacaoCadastralMotivo": "SEM MOTIVO",
                          "situacaoCadastralMotivoCodigo": 0,
                          "naturezaJuridica": "Sociedade Anônima Fechada",
                          "naturezaJuridicaCodigo": 2054,
                          "capitalSocial": 10872130000,
                          "porteCodigo": 5,
                          "porte": "Demais",
                          "cnaeFiscal": 6619399,
                          "cnaeDescricao": "Outras atividades auxiliares dos serviços financeiros não especificadas anteriormente",
                          "cnaesSecundarios": [
                            {
                              "codigo": 5913800,
                              "descricao": "Distribuição cinematográfica, de vídeo e de programas de televisão"
                            },
                            {
                              "codigo": 6204000,
                              "descricao": "Consultoria em tecnologia da informação"
                            },
                            {
                              "codigo": 6209100,
                              "descricao": "Suporte técnico, manutenção e outros serviços em tecnologia da informação"
                            }
                          ],
                          "endereco": {
                            "tipoLogradouro": "RUA",
                            "logradouro": "RUA CAPOTE VALENTE",
                            "numero": "120",
                            "complemento": "ANDAR 01 AO 8 E 9 ANDAR CONJ 902 E 16 ANDAR",
                            "bairro": "PINHEIROS",
                            "municipio": "SAO PAULO",
                            "codigoMunicipioIbge": 3550308,
                            "uf": "SP",
                            "cep": "05409000"
                          },
                          "municipio": "SAO PAULO",
                          "uf": "SP",
                          "cep": "05409000",
                          "telefone1": "1122222222",
                          "fax": "1120390556",
                          "regimeTributario": "LUCRO REAL",
                          "regimeTributarioAno": 2024,
                          "regimeTributarioHistorico": [
                            {
                              "ano": 2016,
                              "regime": "LUCRO REAL",
                              "escrituracoes": 1
                            },
                            {
                              "ano": 2017,
                              "regime": "LUCRO REAL",
                              "escrituracoes": 1
                            },
                            {
                              "ano": 2018,
                              "regime": "LUCRO REAL",
                              "escrituracoes": 1
                            }
                          ],
                          "dataInicioAtividade": "2013-06-04",
                          "companyAgeDays": 4907,
                          "statusAgeDays": 4907,
                          "socios": [
                            {
                              "nome": "ARTHUR FERREIRA VALADAO",
                              "documento": "***897248**",
                              "tipo": "Pessoa Física",
                              "qualificacao": "Diretor",
                              "codigoQualificacao": 10,
                              "dataEntradaSociedade": "2021-08-03",
                              "faixaEtaria": "Entre 31 a 40 anos",
                              "codigoFaixaEtaria": 4
                            },
                            {
                              "nome": "BRUNO GUSMAO ROCHA",
                              "documento": "***948396**",
                              "tipo": "Pessoa Física",
                              "qualificacao": "Diretor",
                              "codigoQualificacao": 10,
                              "dataEntradaSociedade": "2025-12-22",
                              "faixaEtaria": "Entre 41 a 50 anos",
                              "codigoFaixaEtaria": 5
                            },
                            {
                              "nome": "CLAUDIO DE NARDI QUEIROZ",
                              "documento": "***313948**",
                              "tipo": "Pessoa Física",
                              "qualificacao": "Diretor",
                              "codigoQualificacao": 10,
                              "dataEntradaSociedade": "2026-05-08",
                              "faixaEtaria": "Entre 41 a 50 anos",
                              "codigoFaixaEtaria": 5
                            }
                          ],
                          "recordType": "company",
                          "source": "minhareceita",
                          "sourceUrl": "https://minhareceita.org/18236120000158",
                          "sourceUpdatedAt": "2026-10",
                          "scrapedAt": "2026-11-10T15:34:40+00:00"
                        }
                      ]
                    }
                  }
                },
                "400": {
                  "description": "Invalid, missing or unknown input fields. Nothing ran.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "$ref": "#/components/schemas/Error"
                      },
                      "example": {
                        "error": "invalid_input",
                        "errorDescription": "mode: required"
                      }
                    }
                  }
                },
                "422": {
                  "description": "The Actor could not complete this request (for example, nothing matches). No results were delivered.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "$ref": "#/components/schemas/Error"
                      }
                    }
                  }
                },
                "500": {
                  "description": "Unexpected failure. Safe to retry.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "$ref": "#/components/schemas/Error"
                      }
                    }
                  }
                },
                "504": {
                  "description": "The request used up its 240 s budget. The results found so far are in partialItems.",
                  "content": {
                    "application/json": {
                      "schema": {
                        "allOf": [
                          {
                            "$ref": "#/components/schemas/Error"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "partialItems": {
                                "type": "array",
                                "items": {
                                  "$ref": "#/components/schemas/Item"
                                }
                              }
                            }
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "components": {
          "schemas": {
            "Item": {
              "type": "object",
              "description": "One result, the same record a normal run saves to its dataset.",
              "properties": {
                "cnpj": {
                  "type": "string"
                },
                "cnpjFormatado": {
                  "type": "string"
                },
                "cnpjRaiz": {
                  "type": "string"
                },
                "isMatriz": {
                  "type": "boolean"
                },
                "tipoUnidade": {
                  "type": "string"
                },
                "razaoSocial": {
                  "type": "string"
                },
                "situacaoCadastralCodigo": {
                  "type": "integer"
                },
                "situacaoCadastral": {
                  "type": "string"
                },
                "dataSituacaoCadastral": {
                  "type": "string"
                },
                "situacaoCadastralMotivo": {
                  "type": "string"
                },
                "situacaoCadastralMotivoCodigo": {
                  "type": "integer"
                },
                "naturezaJuridica": {
                  "type": "string"
                },
                "naturezaJuridicaCodigo": {
                  "type": "integer"
                },
                "capitalSocial": {
                  "type": "number"
                },
                "porteCodigo": {
                  "type": "integer"
                },
                "porte": {
                  "type": "string"
                },
                "cnaeFiscal": {
                  "type": "integer"
                },
                "cnaeDescricao": {
                  "type": "string"
                },
                "cnaesSecundarios": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "endereco": {
                  "type": "object"
                },
                "municipio": {
                  "type": "string"
                },
                "uf": {
                  "type": "string"
                },
                "cep": {
                  "type": "string"
                },
                "telefone1": {
                  "type": "string"
                },
                "fax": {
                  "type": "string"
                },
                "regimeTributario": {
                  "type": "string"
                },
                "regimeTributarioAno": {
                  "type": "integer"
                },
                "regimeTributarioHistorico": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "dataInicioAtividade": {
                  "type": "string"
                },
                "companyAgeDays": {
                  "type": "integer"
                },
                "statusAgeDays": {
                  "type": "integer"
                },
                "socios": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "recordType": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                },
                "sourceUrl": {
                  "type": "string"
                },
                "sourceUpdatedAt": {
                  "type": "string"
                },
                "scrapedAt": {
                  "type": "string"
                }
              },
              "example": {
                "cnpj": "18236120000158",
                "cnpjFormatado": "18.236.120/0001-58",
                "cnpjRaiz": "18236120",
                "isMatriz": true,
                "tipoUnidade": "Matriz",
                "razaoSocial": "NU PAGAMENTOS S.A. - INSTITUICAO DE PAGAMENTO",
                "situacaoCadastralCodigo": 2,
                "situacaoCadastral": "Ativa",
                "dataSituacaoCadastral": "2013-06-04",
                "situacaoCadastralMotivo": "SEM MOTIVO",
                "situacaoCadastralMotivoCodigo": 0,
                "naturezaJuridica": "Sociedade Anônima Fechada",
                "naturezaJuridicaCodigo": 2054,
                "capitalSocial": 10872130000,
                "porteCodigo": 5,
                "porte": "Demais",
                "cnaeFiscal": 6619399,
                "cnaeDescricao": "Outras atividades auxiliares dos serviços financeiros não especificadas anteriormente",
                "cnaesSecundarios": [
                  {
                    "codigo": 5913800,
                    "descricao": "Distribuição cinematográfica, de vídeo e de programas de televisão"
                  },
                  {
                    "codigo": 6204000,
                    "descricao": "Consultoria em tecnologia da informação"
                  },
                  {
                    "codigo": 6209100,
                    "descricao": "Suporte técnico, manutenção e outros serviços em tecnologia da informação"
                  }
                ],
                "endereco": {
                  "tipoLogradouro": "RUA",
                  "logradouro": "RUA CAPOTE VALENTE",
                  "numero": "120",
                  "complemento": "ANDAR 01 AO 8 E 9 ANDAR CONJ 902 E 16 ANDAR",
                  "bairro": "PINHEIROS",
                  "municipio": "SAO PAULO",
                  "codigoMunicipioIbge": 3550308,
                  "uf": "SP",
                  "cep": "05409000"
                },
                "municipio": "SAO PAULO",
                "uf": "SP",
                "cep": "05409000",
                "telefone1": "1122222222",
                "fax": "1120390556",
                "regimeTributario": "LUCRO REAL",
                "regimeTributarioAno": 2024,
                "regimeTributarioHistorico": [
                  {
                    "ano": 2016,
                    "regime": "LUCRO REAL",
                    "escrituracoes": 1
                  },
                  {
                    "ano": 2017,
                    "regime": "LUCRO REAL",
                    "escrituracoes": 1
                  },
                  {
                    "ano": 2018,
                    "regime": "LUCRO REAL",
                    "escrituracoes": 1
                  }
                ],
                "dataInicioAtividade": "2013-06-04",
                "companyAgeDays": 4907,
                "statusAgeDays": 4907,
                "socios": [
                  {
                    "nome": "ARTHUR FERREIRA VALADAO",
                    "documento": "***897248**",
                    "tipo": "Pessoa Física",
                    "qualificacao": "Diretor",
                    "codigoQualificacao": 10,
                    "dataEntradaSociedade": "2021-08-03",
                    "faixaEtaria": "Entre 31 a 40 anos",
                    "codigoFaixaEtaria": 4
                  },
                  {
                    "nome": "BRUNO GUSMAO ROCHA",
                    "documento": "***948396**",
                    "tipo": "Pessoa Física",
                    "qualificacao": "Diretor",
                    "codigoQualificacao": 10,
                    "dataEntradaSociedade": "2025-12-22",
                    "faixaEtaria": "Entre 41 a 50 anos",
                    "codigoFaixaEtaria": 5
                  },
                  {
                    "nome": "CLAUDIO DE NARDI QUEIROZ",
                    "documento": "***313948**",
                    "tipo": "Pessoa Física",
                    "qualificacao": "Diretor",
                    "codigoQualificacao": 10,
                    "dataEntradaSociedade": "2026-05-08",
                    "faixaEtaria": "Entre 41 a 50 anos",
                    "codigoFaixaEtaria": 5
                  }
                ],
                "recordType": "company",
                "source": "minhareceita",
                "sourceUrl": "https://minhareceita.org/18236120000158",
                "sourceUpdatedAt": "2026-10",
                "scrapedAt": "2026-11-10T15:34:40+00:00"
              }
            },
            "Error": {
              "type": "object",
              "required": [
                "error",
                "errorDescription"
              ],
              "properties": {
                "error": {
                  "type": "string",
                  "enum": [
                    "invalid_input",
                    "request_failed",
                    "internal_error",
                    "timeout",
                    "busy",
                    "not_found",
                    "method_not_allowed",
                    "payload_too_large"
                  ]
                },
                "errorDescription": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "buildNumber": "1.0.3",
    "imageDigest": "91d6874a75d02ee497538cb3497cf8944c1e8e9339e7a24208db81c85ab8de82",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.009621111111111112
    }
  }
}