nvNeuralVerge
Corporate registry

Brazil Company Registry API and MCP — CNPJ Lookup with Officers and Branches

Send a CNPJ, the Brazilian company registration number, and you get one company record: registered and trade name, status, registration date, address, legal form, share capital and size class, whether it is a headquarters or a branch, and its activities as CNAE codes.

You send
a CNPJ number or a registry URL
You get back
Name, status, address, legal form, activities, officers and branches
Coverage
Brazil — entities on CNPJ (Receita Federal).
Price
5 pts — $5 per 1,000
Charged only when the record resolves. A lookup that finds nothing is not billed.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
CNPJ (Receita Federal) directlyOpen CNPJ (Receita Federal) and read the recordUsually free, sometimes per-documentA different interface, language and data shape for every country you add
Collecting it yourselfBuild and host a crawler per register, then keep each one aliveInfrastructure and maintenanceRegisters change their pages without warning, and nobody is on the hook when yours breaks
NeuralVergeOne request, the same shape as every other source in the catalog$5 per 1,000, misses not billedCovers Brazil — other countries are separate sources with the same request format
Response

What you get back

Every field in the example response below.

FieldTypeDescription
session_idstringId of this run, for tracing.
kindstringAlways "br_companies".
companystringThe identifier you sent.
company_idstringThe identifier as the register keys it.
humanstringReadable Markdown summary of the record.
machine.companyobjectThe company record, described below.
machine.blockedbooleanFalse when the register answered normally.
machine.pages_openednumberRegister pages read for this record.
machine.proxy_traffic_bytesnumberData transferred for the run.
total_pointsnumberPoints charged: 5 for a resolved lookup.
machine.company.registration_numberstringThe CNPJ as 14 digits.
machine.company.namestringRegistered company name.
machine.company.trade_namestringTrade name (nome fantasia).
machine.company.statusstringRegistration status, for example Ativa (active).
machine.company.status_datestringDate the status took effect.
machine.company.addressstringAddress on one line, with postal code.
machine.company.urlstringLink to the CNPJ record.
machine.company.company_typestringLegal form (natureza jurídica).
machine.company.incorporation_datestringRegistration date, YYYY-MM-DD.
machine.company.sizestringSize class as published.
machine.company.share_capitalstringShare capital as a formatted string with the R$ prefix.
machine.company.establishment_typestringMatriz (head office) or a branch.
machine.company.state_registrationstringState registration number.
machine.company.meistringWhether the company is a MEI (microentrepreneur), Sim or Não.
machine.company.simplesstringWhether the company is under the Simples tax regime, Sim or Não.
machine.company.municipalitystringMunicipality.
machine.company.statestringState.
machine.company.zipstringPostal code.
machine.company.activitystringPrimary activity as code and description.
machine.company.secondary_activitiesarraySecondary activities as strings.
machine.company.officersarrayOfficers with name and role.
machine.company.responsible_qualificationstringQualification of the person responsible for the entry.
machine.company.state_registrationsarrayState registrations with state and number.
machine.company.mailing_addressstringMailing address on one line.
machine.company.cnae_primaryobjectPrimary CNAE activity as code and description.
machine.company.cnae_secondaryarraySecondary CNAE activities as code and description pairs.
machine.company.headquartersnullEmpty in the sample, where the record is itself the head office.
machine.company.branches_totalnumberTotal number of branches.
machine.company.branchesarrayBranches shown, each with registration_number, name, state and city.
Response

Example response

A real response, as returned.

{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "br_companies",
  "company": "33000167000101",
  "company_id": "33000167000101",
  "human": "# Brazil — CNPJ — company\n\n- **Number:** 33000167000101\n- **Pages opened:** 1\n- **Proxy traffic:** 125.2 KB\n- **Name:** Petroleo Brasileiro S A Petrobras\n- **Status:** Ativa\n- **Type:** Sociedade de Economia Mista\n- **Registered:** 1966-09-28\n- **Address:** Avenida Republica do Chile, 65, Centro, Rio de Janeiro - RJ, 20031-170",
  "machine": {
    "company": {
      "registration_number": "33000167000101",
      "name": "Petroleo Brasileiro S A Petrobras",
      "trade_name": "Petrobras - Edise",
      "status": "Ativa",
      "address": "Avenida Republica do Chile, 65, Centro, Rio de Janeiro - RJ, 20031-170",
      "url": "https://cnpj.biz/33000167000101",
      "company_type": "Sociedade de Economia Mista",
      "incorporation_date": "1966-09-28",
      "size": "Sem Enquadramento",
      "share_capital": "R$ 205.431.960.490,52",
      "establishment_type": "Matriz",
      "status_date": "2005-11-03",
      "state_registration": "81.281.88-2",
      "mei": "Não",
      "simples": "Não",
      "municipality": "Rio de Janeiro",
      "state": "Rio de Janeiro",
      "zip": "20031-170",
      "activity": "06.00-0-01 - Extração de petróleo e gás natural",
      "secondary_activities": [
        "86.30-5-99 - Atividades de atenção ambulatorial não especificadas anteriormente",
        "19.21-7-00 - Fabricação de produtos do refino de petróleo"
      ],
      "officers": [
        {
          "name": "Angelica Garcia Cobas Laureano",
          "role": "Diretor"
        },
        {
          "name": "Clarice Coppetti",
          "role": "Diretor"
        }
      ],
      "responsible_qualification": "Diretor",
      "state_registrations": [
        {
          "state": "RJ",
          "number": "81.281.88-2"
        }
      ],
      "mailing_address": "Petrobras - Edise Petroleo Brasileiro S A Petrobras, Avenida Republica do Chile 65, Centro, Rio de Janeiro RJ, 20031-170,",
      "cnae_primary": {
        "code": "06.00-0-01",
        "description": "Extração de petróleo e gás natural"
      },
      "cnae_secondary": [
        {
          "code": "86.30-5-99",
          "description": "Atividades de atenção ambulatorial não especificadas anteriormente"
        },
        {
          "code": "19.21-7-00",
          "description": "Fabricação de produtos do refino de petróleo"
        }
      ],
      "headquarters": null,
      "branches_total": 476,
      "branches": [
        {
          "registration_number": "33000167010840",
          "name": "Petrobras",
          "state": "SP",
          "city": "São Paulo"
        },
        {
          "registration_number": "33000167002660",
          "name": "Petrobras - Ute Nova Piratininga",
          "state": "SP",
          "city": "São Paulo"
        }
      ]
    },
    "blocked": false,
    "pages_opened": 1,
    "proxy_traffic_bytes": 128161
  },
  "total_points": 5
}
Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

One company per request. Pass the registration number or the link to the record on the register.

curl -X POST https://api.neuralverge.ai/functions/v1/run-br-companies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"33000167000101"}'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Customer and supplier verification

Check that a CNPJ matches the company name and that its status is Ativa.

Credit and onboarding review

Read legal form, share capital, size class and officers for a file.

Mapping a corporate group

Follow the branches list to see where a company operates.

Sales enrichment

Add CNAE activity codes, municipality and state to Brazilian accounts.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Brazil — entities on CNPJ (Receita Federal).

Freshness

Read at request time, so the answer reflects the register as it stands when you ask.

Handling

CNPJ (Receita Federal) is a public register. Every response carries the source URL it was read from and a session id you can trace.

What it will not do
  • —The branches array shows a selection; branches_total is the full count.
  • —Share capital comes back as a formatted string, not a number.
  • —Fields such as headquarters can be null depending on the establishment.
FAQ

Questions, answered

Send the 14 digits, as in the sample. The record also accepts a registry URL.

Related

Related sources

Try brazil company on your own data

One request format across every source in the catalog.

Get started