CPF/CNPJ

Validate and enrich Brazilian tax identification numbers in real time, querying CPF for individuals and CNPJ for companies against Receita Federal. Agents confirm an identity before onboarding or invoicing.

8 actions API key available

CPF/CNPJ website ↗ Platform Documentation ↗ Capability data verified 2026-07-31

A Brazilian applicant submits a CPF or CNPJ during signup

Check Package Balance confirms credit remains before any paid lookup runs

Look Up CPF or Look Up CNPJ queries Receita Federal in real time

Legal name, address, registration status, and partner structure are written to the CRM record

Get Correctional Certificates screens the document against the CGU sanction registers

Compliance owner rules on any sanction hit or PEP flag before the account is touched

What This Integration Enables

Most counterparty verification stops at the company. This one does not. CPF resolves a natural person against Receita Federal, returning full name, date of birth, mother's name, registration status, death records, address, and PEP status depending on the data package you select. CNPJ resolves a company: legal and trade name, address, activity start date, CNAE codes, legal nature, size, Simples Nacional and SIMEI status, state registrations, and the full partner and administrator structure with ownership percentages, in both the numeric and the new alphanumeric CNPJ format. Search Companies By Name closes the loop when you have a trade name and need the number.

Around that core sit the checks that actually decide something. Get Correctional Certificates screens up to ten documents in a single call against the CGU registers of sanctioned individuals and companies and returns an official certificate PDF for each. Run Credit Analysis returns score, presumed income, suggested limit, overdue debts, protests, civil lawsuits, and bounced cheques. Look Up Electronic Invoice retrieves an NF-e from its access key with issuer, recipient, line items, taxes, current status, and full event history. Verify WhatsApp Number confirms a number is reachable before an outreach flow spends anything on it. Every operation runs against a package you choose, so you control which fields come back and which credit balance is consumed, and Check Package Balance is free, which makes it the natural guard at the top of a flow.

Without FlowRunner

Identity taken at face value The tax ID is checked for format and never checked against the registry that issued it

Screening done at contract time Sanction checks happen late, after work has already started with the counterparty

Adverse findings handled ad hoc A hit arrives by email and the decision to act on it leaves no record of who made it

With FlowRunner

Identity resolved at the source Look Up CPF and Look Up CNPJ answer from Receita Federal with same-day data

Screening at first contact Get Correctional Certificates runs on signup across six CGU registers in one batch call

Adverse findings routed and recorded Every hit becomes a named human decision with the certificate PDF attached to it

Use Case Scenarios

Signup Identity Resolution

A Brazilian applicant enters a tax ID at signup. The agent runs Check Package Balance first, because a paid lookup that fails on an exhausted balance is a worse outcome than a queued signup. It then runs Look Up CPF for an individual or Look Up CNPJ for a company, punctuation stripped automatically, and writes the returned legal name, address, and registration status onto the record in HubSpot or Salesforce. Where the applicant typed a company name rather than a number, Search Companies By Name resolves it to a CNPJ first. Error codes are handled as data rather than as failures: 100 and 200 mean the document is invalid, 102 and 202 mean it does not exist. Those are different problems, they route to different places, and neither one becomes a stack trace in a log nobody reads.

Supplier Screening Before Contracting

Procurement is about to onboard a batch of new suppliers. The agent collects the CPF and CNPJ documents and sends up to ten per call to Get Correctional Certificates, which covers the CEIS, CEPIM, CNEP, CGU-PJ, ePAD, and CEAF registers in one pass. Each document comes back with a per-source result, a clear or not-clear flag, and the official certificate as a PDF. Clear suppliers continue through onboarding with their certificates attached to the vendor record as evidence that the check was run and when. Not-clear suppliers stop where they are. The agent does not interpret the listing, it delivers it.

Credit Terms on Evidence Rather Than Instinct

A customer asks for payment terms. The agent runs Run Credit Analysis on their document and handles the asynchronous behaviour properly: the first call answers with estado "processando", so the flow repeats the identical call after about a minute until estado is "concluido", knowing the credit is charged once on completion and the result stays cached for an hour. It assembles the score, presumed income, overdue debts, protests, and any bounced cheques into a single summary and posts it to the finance channel in Slack. It proposes a limit. It does not set one. The person who owns the receivable reads the evidence and decides how much of the company's money to put at risk, and the agent records the approved limit against the analysis that supported it.

Human-in-Loop Highlight

The gate here is not a payment or a write, it is adverse action against a named human being. When Get Correctional Certificates returns not-clear on a CPF, or Look Up CPF comes back with a PEP flag or a death record, the agent has a finding, not a verdict. Registry matches on individuals produce namesakes, and a person wrongly rejected on a sanction match has no idea why and no easy path to fix it. So the agent stops before anything touches the account. It posts to the compliance queue: "CPF ending 4471, applicant name as typed [name], Receita Federal name [name], CEIS hit on register entry dated [date], certificate PDF attached, date of birth match [yes or no]. Reject, request documents, or clear as a namesake?" The compliance owner decides, and their name goes on the decision. Everything clear flows straight through onboarding without a person ever seeing it, which is the point: automation carries the volume and a human owns the small number of cases where being wrong costs somebody their account. That division is what an automation exception is for, and it is why human-in-the-loop belongs on this connector specifically rather than on the ones that only ever look at companies.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

8 actions

Individuals

Look Up CPF Queries a Brazilian individual taxpayer number against Receita Federal in real time and returns the fields in the selected package: full name, date of birth, mother's name, gender, registration status, death records, address, PEP status, or an official receipt PDF. The document may be sent masked or unmasked. Invalid, wrong-length, and non-existent numbers return distinct error codes so a flow can route each one differently.

Companies

Look Up CNPJ Queries a Brazilian company taxpayer number against Receita Federal in real time and returns the fields in the selected package: legal and trade name, address, activity start date, phones, email, CNAE codes, legal nature, size, partners and administrators with ownership percentages, Simples Nacional and SIMEI status, state registrations, or the official CNPJ card as a PDF. Both numeric and the new alphanumeric CNPJ format are accepted.
Search Companies By Name Searches companies by legal name or part of one and returns matching CNPJ numbers as unmasked digits. Used to turn a name captured in a form into a number that Look Up CNPJ can resolve into a full profile.

Screening and Credit

Get Correctional Certificates Retrieves Comptroller General sanction certificates for up to ten CPF or CNPJ documents in one batch, covering the CEIS, CEPIM, CNEP, CGU-PJ, ePAD, and CEAF registers. Each document returns a per-source result, a clear or not-clear flag, and the official certificate as a PDF. Each document returned consumes one credit.
Run Credit Analysis Runs a credit analysis on a CPF or CNPJ, returning score, presumed income, suggested credit limit, overdue debts, protests, civil lawsuits, bounced cheques, and alerts according to the selected data source. The call is asynchronous: it first answers with estado "processando", so repeat the identical call after about a minute until estado is "concluido". The result caches for an hour and the credit is charged once, on completion.

Fiscal Documents

Look Up Electronic Invoice Retrieves a Brazilian NF-e in real time from its 44-digit access key, for individuals and companies alike. Returns general invoice data, issuer and recipient, line items, totals, taxes, current status such as authorised, cancelled, or denied, and the full event history. The returned structure varies with the invoice status.

Contact Verification

Verify WhatsApp Number Checks whether a phone number in E.164 format has an active WhatsApp account and, depending on the package, returns the avatar, whether it is a Business account, and the business profile with description, category, website, email, address, and product catalogue. Results cache for one hour, every query is charged including when there is no account, and WhatsApp packages share a limit of two requests per second.

Account

Check Package Balance Returns the remaining credit balance of one data package with its id and name. The call is free and consumes nothing, which makes it the correct guard at the top of a flow that is about to run paid lookups, and the correct scheduled check for low-balance alerting.

Frequently Asked Questions

What can FlowRunner do with CPF/CNPJ?

FlowRunner agents can run Look Up CPF, Look Up CNPJ, and Search Companies By Name in CPF/CNPJ, plus 5 more actions.

Does connecting CPF/CNPJ to FlowRunner require OAuth?

No. CPF/CNPJ connects to FlowRunner with an API key, no OAuth flow required.

Can CPF/CNPJ trigger a FlowRunner workflow automatically?

CPF/CNPJ doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.

Start building with CPF/CNPJ

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us