# KYB Brasil – Brazilian Business Prospecting List

> KYB Brasil – Brazilian Business Prospecting List is a paid API for AI agents from kyb-br-agents.marcelfons.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-18).

Returns one page of 100 active Brazilian business establishments from Receita Federal matching filters like CNAE activity code, state, city, date range, and headquarters-only flag

## Facts

- Endpoint: GET https://kyb-br-agents.marcelfons.workers.dev/v1/list?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kyb-brasil-brazilian-business-prospecting-list-6b6cdfd3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9s42axWSrPa97l1UIXtld

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 kyb-brasil-brazilian-business-prospecting-list-6b6cdfd3
```

Example prompt: Give me the first page of active Brazilian companies in CNAE 6201 (software development) located in São Paulo state, headquarters only, that opened after 2020-01-01 — I need their CNPJ, legal name, city, and opening date for a prospecting list.

## When to prefer this

Choose this endpoint when you need to prospect or enumerate multiple active Brazilian companies matching specific industry (CNAE), geography (state/city), or founding date criteria — i.e., when you need a list rather than a single CNPJ lookup. It is distinct from single-CNPJ KYB screening endpoints on the same host. Use it for market research, B2B sales prospecting, compliance vendor lists, or any bulk discovery of Brazilian businesses from the authoritative Receita Federal registry. Prefer this over scraping or third-party aggregators when you need attestation-backed, signed data with MEI privacy compliance.

## Known failure modes

- Invalid or malformed CNAE code returns empty results or validation error
- Unknown state UF code returns 400 or empty result set
- Page number out of range returns empty results array
- Invalid date format (not YYYY-MM-DD) may cause 400 bad request
- No matching establishments for given filter combination returns empty list with total=0
- Payment not processed (x402) results in 402 Payment Required response blocking access

## How this service works

Prospecting list: one page of 100 ACTIVE Brazilian establishments matching a filter (CNAE code or prefix, state/UF, city, opening date range, headquarters only), with CNPJ, legal and trade name, city/state, main activity and opening date. Stable paging by CNPJ; total and next_page included. Source: Receita Federal monthly registry; MEI owners' CPFs masked. Signed answer (Ed25519 attestation), verifiable at /v1/verify.

## Output

A JSON page of up to 100 active Brazilian business establishments, each with CNPJ, legal name, trade name, city, state, main CNAE activity code and description, and opening date. Also includes total record count and a next_page token for stable CNPJ-based pagination. The response is signed with an Ed25519 attestation verifiable at /v1/verify. MEI individual owners' CPFs are masked for privacy.

## 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": [],
     "properties": {
      "city": {
       "type": "string",
       "description": "Municipality name."
      },
      "cnae": {
       "type": "string",
       "description": "CNAE code or prefix (6201-5/00, 6201, 62)."
      },
      "page": {
       "type": "string",
       "description": "Page of 100, default 1."
      },
      "state": {
       "type": "string",
       "description": "UF, e.g. SP."
      },
      "hq_only": {
       "type": "string",
       "description": "1 = headquarters only"
      },
      "opened_after": {
       "type": "string",
       "description": "YYYY-MM-DD"
      },
      "opened_before": {
       "type": "string",
       "description": "YYYY-MM-DD"
      }
     }
    }
   },
   "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/kyb-brasil-brazilian-business-prospecting-list-6b6cdfd3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kyb-br-agents.marcelfons.workers.dev](https://www.zero.xyz/host/kyb-br-agents.marcelfons.workers.dev/llms.txt)