NewFacial identity verification

CPF Registration Status Explained: Regular, Suspended, Cancelled

What each Brazilian CPF registration status means, from regular to suspended, cancelled or holder deceased, and how to check the status in your onboarding.

Lucas Vieira
Lucas Vieira
··6 min read
CPF Registration Status Explained: Regular, Suspended, Cancelled

Introduction

Every Brazilian CPF (Brazil's individual taxpayer registry number) has a registration status, the situação cadastral, kept by the Receita Federal (Brazil's Federal Revenue Service). There are six: Regular, Pendente de regularização (pending regularization), Suspensa (suspended), Cancelada (cancelled), Titular falecido (holder deceased) and Nula (null).

Only Regular means the CPF has no issues. The others range from a missing tax return to a number annulled for fraud, and each one deserves a different reaction in an onboarding flow. This guide explains what they mean and how to check them.


The six statuses

The statuses are defined in the Receita Federal's CPF rules (Normative Instruction RFB 2,172/2024). In plain English:

Status (Portuguese)EnglishWhat it usually means
RegularRegularThe CPF is active and has no pending issues
Pendente de regularizaçãoPending regularizationThe holder missed a required filing, typically an income tax return
SuspensaSuspendedThe registration data is inconsistent or incomplete
CanceladaCancelledThe registration was cancelled, for example for duplicate registration or by administrative or court decision
Titular falecidoHolder deceasedThe holder's death has been registered
NulaNullThe registration was annulled, typically after fraud was found

A few points foreign teams often get wrong:

  • Pending and suspended are fixable. The holder can usually regularize the CPF by filing the missing return or updating their data. These are real people with a paperwork problem, not necessarily fraud.
  • Holder deceased is final. A CPF in this status should not open new accounts. Fraud using the identities of people who have died is a known pattern, and this status is how you catch it.
  • Null and cancelled are red flags. A null CPF was annulled, so any attempt to use it needs to stop.

The holder can check their own status and any pending items through the government's CPF consultation service.


How to check the status

Manually

The Receita Federal has a public status page that asks for the CPF and date of birth and shows the status after a captcha. It works for a single check, not for an onboarding flow.

With the Real-Time Lookup

The CPFHub.io Real-Time Lookup queries the Receita Federal at the moment of the call. It needs the CPF and the holder's date of birth, and returns:

  • name, in uppercase
  • situation, the status text as the Receita Federal shows it, in uppercase (for example REGULAR or TITULAR FALECIDO)
  • deathYear, the year of death, or null
  • a link to the proof issued by the Receita Federal, plus a validation link
curl --max-time 60 -X POST https://api.cpfhub.io/cpf/realtime \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cpf": "00000000000", "birthDate": "15/06/1990"}'

The Simple Lookup (GET /cpf/{cpf}) does not return the status. It answers a different question (does the CPF exist, and whose is it) with name, gender and date of birth. Many flows run the Simple Lookup for everyone and the Real-Time Lookup only where the status matters.

Reading the errors

The Real-Time Lookup returns specific codes that are part of the verification itself:

ResponseMeaningCredit
200Status returned1.5 credits
422 birth_date_mismatchThe date of birth does not match the CPFNot charged
422 cpf_not_foundThe CPF does not exist at the Receita FederalNot charged
502 or 503The Receita Federal did not answer in time or is busyNot charged, retry after Retry-After

A birth_date_mismatch deserves attention: the user typed a real CPF with a date of birth that is not the holder's. Field details are in the Real-Time Lookup reference.


What to do with each status

There is no single right policy, and regulated companies should follow their own risk rules and Brazilian counsel. A common starting point:

StatusTypical action
RegularContinue
Pending regularizationContinue, or continue with limits, depending on your product
SuspendedAsk the user to regularize, or send to manual review
CancelledBlock and review
Holder deceasedBlock
NullBlock

Two habits make this work in production:

  1. Normalize the text before comparing. Compare uppercase strings without accents, so PENDENTE DE REGULARIZAÇÃO and PENDENTE DE REGULARIZACAO map to the same rule. Treat any status you do not recognize as "send to review".
  2. Store the proof link with the decision. The proof link documents what the Receita Federal showed at the time of the check, which helps in audits.

Frequently asked questions

What does "CPF suspenso" mean?

A suspended CPF has inconsistent or incomplete registration data at the Receita Federal. The holder can usually fix it by updating their data. It is not proof of fraud, but it is a reason to pause or review.

Can a CPF with "titular falecido" become regular again?

Only if the death was recorded by mistake, and then the holder has to contact the Receita Federal with documents to correct it. For onboarding purposes, treat it as a block.

Does the Simple Lookup return the CPF status?

No. The Simple Lookup returns name, gender and date of birth. The status, year of death and proof come only from the Real-Time Lookup, which needs the date of birth.

Can I check CPF status in bulk?

The Real-Time Lookup is not available in bulk. It runs one CPF per request, with a per-minute limit per API key. For existence and identity data at volume, use the bulk CPF lookup.


Read also

Conclusion

A CPF status tells you more than whether the number exists: it shows whether the registration is in order, has a paperwork problem, was cancelled or annulled, or belongs to someone who has died. Map each status to an action, store the proof and keep the Real-Time Lookup for the steps where the status changes your decision.

Try the Real-Time Lookup with 50 free credits and no credit card at cpfhub.io.

CPFHub.io

Ready to integrate the API?

50 free credits to test now. No credit card. Instant access to the documentation.

WhatsApp