{"uid":"cap_rIhmX4zC_XY6TNJ6pt9s6","slug":"brazilayer-cnpj-status-check-a28ba703","name":"Brazilayer CNPJ Status Check","description":"Does this CNPJ exist in the official Receita Federal registry, and is it active? Returns existence, registration status (situacao_cadastral: Ativa=active, Suspensa=suspended, Baixada=closed) with date, headquarters/branch flag and state. Cheapest paid check in the catalog: digit arithmetic alone cannot tell a well-formed number from a real, active company. Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra","url":"https://api.brazilayer.com/v1/cnpj/situacao/:cnpj","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"},"pathParams":{"cnpj":{"type":"string","description":"Brazilian company tax ID (CNPJ), 14 digits, with or without punctuation (e.g. 00000000000191 or 00.000.000/0001-91)"},"type":"object"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eiAJS-8N9SuY406omWnFe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a Brazilian CNPJ exists in the Receita Federal registry and returns its current registration status (active, suspended, or closed) along with headquarters/branch flag and state.","exampleAgentPrompt":"Can you check whether CNPJ 11.222.333/0001-81 actually exists and is currently active in the Brazilian Receita Federal registry — not just a well-formed number, but a real, registered company?","exampleUseCases":[{"title":"Supplier due diligence before payment","prompt":"Before we wire money to this Brazilian supplier, can you verify that their CNPJ 45.678.901/0001-23 is real and shows as Ativa in the Receita Federal registry?"},{"title":"Onboarding KYC for Brazilian business customer","prompt":"We're onboarding a new Brazilian corporate client who gave us CNPJ 12.345.678/0001-95 — please check whether it exists and what its current registration status is in the official registry."},{"title":"Detecting closed or suspended companies","prompt":"I found a Brazilian company using CNPJ 98.765.432/0001-10 on an invoice — can you tell me if that CNPJ is active, suspended, or already baixada (closed)?"}],"resultDescription":"Returns whether the CNPJ exists in the official Receita Federal registry, its situacao_cadastral (Ativa = active, Suspensa = suspended, Baixada = closed) with the date of that status, a flag indicating whether the registration is for the headquarters or a branch, and the Brazilian state where it is registered.","failureModes":["CNPJ not found in registry — returns existence: false","Malformed CNPJ input (not 14 digits after stripping punctuation) — likely returns 4xx error","Receita Federal data temporarily unavailable — upstream outage may return 5xx","CNPJ passes digit arithmetic but does not exist as a real registration — correctly returns non-existent"],"whenToPreferThis":"Choose this endpoint when you need a fast, cheap ($0.001) authoritative check on whether a CNPJ is real and active — especially when digit-arithmetic validation alone is insufficient and you need ground-truth status from the official Receita Federal registry. Prefer this lightweight status endpoint over the full CNPJ data or bundle endpoints when you only need existence and registration status, not full company details or partner/shareholder data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:42:58.135Z","isFirstParty":false}