{"uid":"cap_YDKXji3Q7XVmNu9hp1nYj","slug":"miniframe-cnpj-company-profile-enrichment-c85f4621","name":"MiniFrame CNPJ Company Profile Enrichment","description":"Use when you need a Brazilian company profile ready to qualify a lead, not the raw registry. Looks up the CNPJ, completes the address via CEP, and adds derived flags: active, headquarters, age in years, MEI/Simples, size and risk signals. JSON body { cnpj } (14 digits). Personal fields omitted; partner tax IDs stay masked.","url":"https://tools.miniframe.com.br/empresa","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cnpj":{"type":"string","description":"Brazilian company tax ID, 14 digits."}}},"responseSchema":{"type":"json","example":{"cnpj":"00000000000191","status":"Ativa","address":{"zip":"70073901","city":"Brasília","state":"DF","street":"Setor Bancario Sul","zip_matches_city":true},"insights":{"risk":[],"size":"DEMAIS","is_mei":false,"age_years":60,"is_active":true,"is_simples":false,"is_headquarters":true},"partners":[{"name":"FULANO DE TAL","role":"Diretor","tax_id_masked":"***550179**"}],"trade_name":"","company_name":"BANCO DO BRASIL SA","main_activity":{"code":6422100,"description":"Bancos múltiplos, com carteira comercial"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0m_yj5dDmQMY0SDObRZW4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up a Brazilian company by CNPJ, enriches the record with CEP-completed address, and adds derived business flags including active status, HQ indicator, company age, MEI/Simples Nacional enrollment, size classification, and risk signals.","exampleAgentPrompt":"I need to qualify a Brazilian supplier — can you look up CNPJ 12345678000195 and tell me if they're active, whether they're a headquarters, how old the company is, their size, and whether they're on Simples Nacional or MEI?","exampleUseCases":[{"title":"B2B lead qualification before outreach","prompt":"Before we add this Brazilian prospect to our CRM, look up CNPJ 00000000000191 and tell me if the company is active, how old they are, what size they are, and if there are any risk signals I should know about."},{"title":"Supplier onboarding compliance check","prompt":"We're onboarding a new Brazilian supplier with CNPJ 11222333000181 — can you check if they're a real active company, confirm they're the headquarters and not a branch, and flag anything risky?"},{"title":"Invoice validation before payment","prompt":"I just received an invoice from a Brazilian company with CNPJ 45678901000123 — can you verify they're active and get me their full enriched address and MEI or Simples status before I approve payment?"}],"resultDescription":"A structured JSON object containing the company's official registry data, address completed via CEP lookup, derived boolean flags (active, is_headquarters, is_mei, is_simples_nacional), company age in years, size classification, risk signals, and masked partner tax IDs. Personal fields are omitted for privacy.","failureModes":["Invalid or malformed CNPJ (not 14 digits) returns a validation error","CNPJ not found in Brazilian registry returns a not-found error","CEP address lookup failure may result in incomplete address data","Inactive or cancelled companies are returned but flagged as inactive","Rate limiting or payment authorization failure returns a 402 error"],"whenToPreferThis":"Choose this endpoint when you need a lead-qualification-ready company profile rather than a raw registry dump. It is specifically valuable when you need derived business intelligence flags (active status, HQ vs branch, MEI/Simples, age, size, risk signals) in a single call rather than stitching together multiple raw data sources. Prefer this over a raw CNPJ lookup endpoint when the consumer is a sales, compliance, or onboarding workflow that needs actionable enriched data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:42.802Z","isFirstParty":false}