{"uid":"cap_3cuAppm_wHV-lRVLshXbs","slug":"brazilian-public-data-api-favorecidos-pj-legal-entities-03fa90b7","name":"Brazilian Public Data API — Favorecidos PJ (Legal Entities)","description":"Consultas a dados públicos brasileiros, pagas por chamada em USDC via x402.","url":"https://x402.spectro.sh/v1/favorecidos?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"document":{"type":"string","maxLength":18,"minLength":14,"description":"CNPJ, com ou sem pontuação (o alfanumérico também). CPF não é aceito: este serviço consulta apenas pessoas jurídicas."}}},"responseSchema":{"type":"json","example":{"data":{"favorecidos":{"list":[{"uf":"DF","cnpj":"12345678000195","municipio":"BRASILIA","secaoCnae":"F","codigoCnae":"4321500","tipoPessoa":"PESSOA JURIDICA","razaoSocial":"EMPRESA EXEMPLO DE SERVICOS LTDA","nomeFantasia":"EXEMPLO SERVICOS","descricaoCnae":"Instalação e manutenção elétrica","descricaoSecaoCnae":"CONSTRUÇÃO","tipoNaturezaJuridica":"Entidades Empresariais","codigoNaturezaJuridica":"2062","descricaoNaturezaJuridica":"Sociedade Empresária Limitada"}],"total":1}},"error":false,"product":"favorecidos","requestId":"3f2b7c1e-8a4d-4c9f-b0e6-1d5a9c7e2b40","provenance":{"url":"https://portaldatransparencia.gov.br/download-de-dados/favorecidos-pj","sha256":"5d89a70f0467ec649ab9a7bf6d83ce1ed1f851ad4a6a0485092ed03968094e19","source":"Portal da Transparência (CGU): Favorecidos PJ","datasets":[{"id":"favorecidos_pj","fields":["favorecidos"],"period":"202512","checkedAt":"2026-01-06T07:04:00Z","updatedAt":"2026-01-05T07:04:00Z"}],"retrievedAt":"2026-01-01T00:00:00Z"}}},"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_mZB9lJ1yAOFjtTv7QKOqr","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 Brazilian federal government payment beneficiary data for a given CNPJ (legal entity), returning company name, CNAE activity code, municipality, legal nature, and other public registry fields from the Portal da Transparência.","exampleAgentPrompt":"Can you look up the official name, CNAE activity code, and municipality for the Brazilian company with CNPJ 12.345.678/0001-95 using the Portal da Transparência favorecidos data?","exampleUseCases":[{"title":"Vendor due diligence before contracting","prompt":"Before we sign a contract with this Brazilian supplier, can you pull their official company name, legal nature, and main activity sector from the government transparency data for CNPJ 34.567.890/0001-12?"},{"title":"Enriching a CRM with company sector data","prompt":"I have a list of Brazilian client CNPJs and I need to know their CNAE industry code and municipality — can you start with 56.789.012/0001-34 and fetch that from the government's favorecidos registry?"},{"title":"Auditing a government payment beneficiary","prompt":"We're auditing federal disbursements and need to verify the razão social and CNAE description for the entity registered under CNPJ 78.901.234/0001-56 — can you fetch that from the Portal da Transparência?"}],"resultDescription":"Returns a JSON object with the matched company's full legal name (razão social), trade name (nome fantasia), CNAE code and description, CNAE section code and description, state (UF), municipality, legal nature code and description, entity type (pessoa jurídica), plus metadata including the source dataset period, provenance SHA256, and a unique requestId for auditability.","failureModes":["Invalid or malformed CNPJ input (too short, wrong format) — likely returns a validation error","CNPJ not found in the favorecidos dataset — returns an empty list with total 0","CPF (individual taxpayer number) submitted instead of CNPJ — service explicitly rejects CPFs","Dataset may lag real-time registry changes; data reflects the most recent monthly snapshot (e.g. period 202512)","Payment failure or insufficient USDC balance via x402 — request not processed"],"whenToPreferThis":"Use this endpoint when you need to look up Brazilian legal entities (companies, NGOs, public bodies) by CNPJ and want official government-sourced data including CNAE sector classification, legal nature, and municipality, especially for compliance, vendor onboarding, or audit workflows. Prefer this over scraping the Portal da Transparência directly since it is a structured, pay-per-call API with provenance metadata included. Not suitable for individual CPF lookups or real-time CNPJ status checks (use the Receita Federal for those).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T00:36:29.552Z","isFirstParty":false,"canonicalSlug":"brazilian-public-data-api-favorecidos-pj-legal-entities-03fa90b7"}