{"uid":"cap_pm1OFtg29y5xICPMkdJzj","slug":"miniframe-cnpj-lookup-20888661","name":"MiniFrame CNPJ Lookup","description":"Use when you need a Brazilian company's official record from its CNPJ — checking a supplier is active, confirming a legal name, enriching a lead. JSON body { cnpj } (14 digits). Returns name, status, address, CNAE activities, share capital and the public partner list (QSA) with masked tax IDs. Personal contact fields omitted.","url":"https://tools.miniframe.com.br/cnpj","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cnpj":{"type":"string","description":"Brazilian company tax ID, 14 digits (with or without punctuation)."}}},"responseSchema":{"type":"json","example":{"cnpj":"00000000000191","size":"DEMAIS","is_mei":false,"source":"brasilapi","status":"ATIVA","address":{"zip":"01310100","city":"São Paulo","state":"SP"},"partners":[{"name":"FULANO DE TAL","role":"Diretor","tax_id_masked":"***550179**"}],"company_name":"BANCO DO BRASIL SA","main_activity":{"code":6422100,"description":"Bancos múltiplos"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O3vcrn5wJwSqgAmbB3I76","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches official Brazilian company registry data for a given CNPJ tax ID, returning legal name, status, address, CNAE activities, share capital, and partner list (QSA).","exampleAgentPrompt":"Can you pull the official registration details for Brazilian company CNPJ 11222333000181 — I need to confirm their legal name, whether they're active, their registered address, and who the partners are?","exampleUseCases":[{"title":"Validate supplier before vendor onboarding","prompt":"I'm about to sign a contract with a new Brazilian supplier — can you check their CNPJ 07526847000145 to verify they're an active company, confirm their legal name matches what they told us, and see who the actual owners are?"},{"title":"Enrich sales lead with official company data","prompt":"We have a potential client in Brazil with CNPJ 28865114000102 — pull their official registration so I can see their legal name, what business activities they're registered for, their office address, and who owns the company before I reach out?"},{"title":"KYC due diligence for business transaction","prompt":"Before we proceed with this partnership agreement, I need you to look up CNPJ 34028316000152 in the official registry — check if they're currently active, what their share capital is, their registered address, and get me the full partner list with any relevant details."}],"resultDescription":"A JSON object containing the company's official legal name, current registration status (active/inactive/etc.), full registered address, list of CNAE economic activities, share capital amount, and the QSA (Quadro de Sócios e Administradores) partner list with masked tax IDs. Personal contact fields are excluded.","failureModes":["Invalid or malformed CNPJ (not 14 digits) — returns validation error","CNPJ not found in the registry — returns 404 or empty result","Upstream Brazilian registry API unavailable — returns 503 or timeout","Rate limiting or payment failure — returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need authoritative, government-sourced Brazilian company data for a specific CNPJ — especially for supplier verification, lead enrichment, KYC due diligence, or confirming legal entity details before a business transaction. Prefer this over web scraping or third-party aggregators when official accuracy and structured output (including QSA partner list and CNAE codes) are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:25.063Z","isFirstParty":false}