# Brazilayer CNPJ Partner Reverse Lookup

> Brazilayer CNPJ Partner Reverse Lookup is a paid API for AI agents from api.brazilayer.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Reverse-lookup all Brazilian companies where a named person or entity appears as a partner or shareholder, using the official Receita Federal CNPJ registry.

## Facts

- Endpoint: GET https://api.brazilayer.com/v1/cnpj/socio/busca
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brazilayer-cnpj-partner-reverse-lookup-e31d4113
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VbbYceVUa-3ohnMQVG689

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brazilayer-cnpj-partner-reverse-lookup-e31d4113
```

Example prompt: Search the Brazilian Receita Federal CNPJ registry for all companies where 'Carlos Alberto Ferreira' appears as a partner or shareholder — give me the company names, CNPJs, his role, and the date he joined each one.

## When to prefer this

Use this endpoint when you need to find all Brazilian companies associated with a specific individual or entity by name — the inverse of a CNPJ company lookup. Ideal for due diligence, KYC, compliance screening, or mapping corporate networks of Brazilian persons. Prefer this over company-by-CNPJ endpoints when you have a name but not a CNPJ, and need to discover all corporate affiliations.

## Known failure modes

- Name string shorter than 3 characters returns a validation error
- No matching partners found returns an empty result set
- Ambiguous or common names return large result sets requiring pagination
- Network or upstream Receita Federal outage may cause 5xx errors
- Accent-insensitive search may still miss unusual name variants

## How this service works

Reverse lookup: find every Brazilian company where a given person or entity appears as partner/shareholder, by name (full-text, accent-insensitive). Returns partner name, company CNPJ and legal name, role and entry date. The highest-value query for due diligence — data straight from the official Receita Federal CNPJ registry (personal tax IDs come pre-masked from the source). Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra

## Output

A paginated list of records from the official Receita Federal CNPJ registry, each containing the matched partner name, the company's CNPJ number and legal name, the partner's role (e.g. socio, administrador), and the date they joined the company. Personal tax IDs (CPFs) are pre-masked at the source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "nome"
     ],
     "properties": {
      "nome": {
       "type": "string",
       "description": "person or entity name, min 3 chars"
      },
      "pagina": {
       "type": "integer"
      },
      "por_pagina": {
       "type": "integer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brazilayer-cnpj-partner-reverse-lookup-e31d4113/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.brazilayer.com](https://www.zero.xyz/host/api.brazilayer.com/llms.txt)