{"uid":"cap_9s42axWSrPa97l1UIXtld","slug":"kyb-brasil-brazilian-business-prospecting-list-6b6cdfd3","name":"KYB Brasil – Brazilian Business Prospecting List","description":"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.","url":"https://kyb-br-agents.marcelfons.workers.dev/v1/list?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q4dkJVne9B9k5a4XstYiH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"B2B sales prospecting by sector and region","prompt":"Pull me a list of 100 active Brazilian fintech companies — CNAE code 6499-9 — headquartered in São Paulo state, opened after 2018-01-01, so I can build a prospecting pipeline for our sales team."},{"title":"Market research for a specific city","prompt":"I need a page of active logistics companies in Curitiba, Paraná — CNAE prefix 49 — so I can analyze how many freight businesses are operating there. Headquarters only please."},{"title":"Compliance vendor screening by industry","prompt":"Can you fetch the first page of active healthcare establishments in Rio de Janeiro state with CNAE code 8630-5, opened before 2023-12-31? I need the CNPJ and legal names to cross-check them against our vendor list."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T18:38:01.764Z","isFirstParty":false,"canonicalSlug":"kyb-brasil-brazilian-business-prospecting-list-6b6cdfd3"}