CPF (Brazil)

Overview

Queries Receita Federal services to validate a taxpayer (CPF) number and return name, date of birth and status—foundational for Brazilian KYC flows.

ID: brazil-cpf-lookup
Type: eID (database)
Verification Type: Enrichment
Regions: Latin America
Countries: BR
Adoption: 180,000,000
URL: https://www.serpro.gov.br/

Integration with Trinsic

CPF verification is integrated into Trinsic's identity acceptance network allowing businesses to verify users against the government system of record in Brazil.

Data Inputs: idNumber (CPF)
Permission required: Yes, this method requires registration before you can activate it for your users. Please contact Trinsic to begin this process.
Cost: Contact the Trinsic team.

User Flow

Trinsic offers a fetch service where the user provides their CPF number and grants consent, then our service responds with a set of verified attributes.

To see a demo of this flow, watch this video.

How to Test

While using a test mode App, launch the widget or the provider directly.

Enter the credentials and submit.
- CPF number: (see credential options below)
- If biometrics is enabled, use the image found below the CPF numbers
At the end, you will be presented with test data for the verification session.

CPF Number	CPF Status	Verification Result
40442820135	Regular	✅ Success
07691852312	Pending Regularization	✅ Success
12345678909	Minor	✅ Success
40532176871	Suspended	❌ Failure
01648527949	Canceled	❌ Failure
98302514705	Nullified	❌ Failure
05137518743	Deceased	❌ Failure

Direct API Requirements

📘
Direct API is not a requirement.
You can integrate with this provider using the Hosted UI instead, with no additional integration requirements on your end.

What your integration must support in order to use this provider with the Direct Provider Sessions API.

Supports Direct Provider Sessions: ✅
Launch Method: None — No user-facing action is required to start the flow.
Collection Method: PollResult — Results arrive asynchronously; poll with the resultsAccessKey returned at session creation.
Requires Input: This provider requires input before verification can proceed.
Trinsic-Hosted UI: A Trinsic-Hosted Fallback UI exists for this provider, which may be invoked to cover gaps in your integration's capabilities.

Outputs

ℹ️
Normalized Attributes
These attributes form part of our normalized model, a standardized set used across providers. Trinsic normalizes this for you and lets you know when a property is available for each provider.

Field	Availability	Notes
`person.fullName`	Always	-
`person.dateOfBirth`	Always	-
`document.number`	Always	-
`match.faceMatch`	Sometimes	If selfie is provided and authoritative source is available
`attachments.selfie`	Sometimes	If selfie is provided and authoritative source is available

Field	Optional	Description	Example Values
`preview_raw_error_code`	Yes	The raw error code for the verification, returned by Serpro. This is a temporary preview to support detailed error handling. When building against this please let the Trinsic team know. Preview features can be turned off without an obsoletion notice.	MinorValidationNotAllowed
`cpfNumber`	Yes	The individual's CPF number. A CPF (Cadastro de Pessoas Físicas) is the Brazilian individual taxpayer identification number for residents and foreigners. It is an 11-digit number managed by the Federal Revenue Service, the last 2 digits are check digits, calculated based on the first 9 digits. The 9th digit indicates the fiscal region responsible for the registration,	40442820135
`fiscalRegions`	Yes	List of Brazilian fiscal regions that could have issued this number. This is calculated based off of the CPF number. A CPF number encodes information about what region it is issued from, but some regions share the identifier. Possible values: Formatted as two characters. The digit represents the region code this applies to. - AC (Acre) - 2 - AL (Alagoas) - 4 - AP (Amapá) - 2 - AM (Amazonas) - 2 - BA (Bahia) - 5 - CE (Ceará) - 3 - DF (Distrito Federal) - 1 - ES (Espírito Santo) - 7 - GO (Goiás) - 1 - MA (Maranhão) - 3 - MT (Mato Grosso) - 1 - MS (Mato Grosso do Sul) - 1 - MG (Minas Gerais) - 6 - PA (Pará) - 2 - PB (Paraíba) - 4 - PR (Paraná) - 9 - PE (Pernambuco) - 4 - PI (Piauí) - 3 - RJ (Rio de Janeiro) - 7 - RN (Rio Grande do Norte) - 4 - RO (Rondônia) - 2 - RS (Rio Grande do Sul) - 0 - RR (Roraima) - 2 - SC (Santa Catarina) - 9 - SP (São Paulo) - 8 - SE (Sergipe) - 5 - TO (Tocantins) - 1	["DF", "GO", "MS", "MT", "TO"]
`statusCode`	Yes	The CPF Status. Possible values: 0 - Regular. The CPF is valid and in good standing. There are no pending issues, registration inconsistencies, or missing mandatory Individual Income Tax Returns (DIRPF). 2 - Suspended. The CPF record contains incorrect or incomplete registration data (e.g., name, date of birth, or voter registration number). This status is typically caused by discrepancies with the Superior Electoral Court (TSE) database or failure to update personal information. 3 - Deceased Holder. The CPF has been registered as belonging to a deceased individual. This status is recorded to prevent post-mortem misuse. 4 - Pending Regularization. The taxpayer has failed to submit one or more mandatory Individual Income Tax Returns (DIRPF) within the last five years. This can occur for various reasons, such as failure to file a mandatory declaration, changes of address, name, marital status, or other important information that does not conform to the records. Regularization requires submission of the overdue returns. 5 - Canceled by Multiplicity. The CPF has been cancelled due to duplicate registration (multiple CPFs assigned to the same individual or a single CPF linked to multiple individuals). 8 - Null. The CPF registration was cancelled due to confirmed fraud or a serious issuance error. Regularization requires in-person verification at a Federal Revenue Service office and may not be guaranteed. 9 - Cancelled Ex Officio. The CPF was cancelled due to administrative or judicial decision, or other registration inconsistencies.	0
`statusDescription`	Yes	Description of the CPF Status.	Regular
`name`	Yes	The full legal name of the individual.	João Silva
`socialName`	Yes	The social name of the individual in case the individual would like to use a different name than their full legal name.	Maria Silva
`dateOfBirth`	Yes	The date of birth of the individual.	1995-09-11
`yearOfDeath`	Yes	Deprecated as of September 1, 2026. The year of death of the individual, if applicable.	2020
`dateOfRegistration`	Yes	The date of registration of the individual with the Federal Revenue Service.	2015-09-11
`biometricVerification.selfieVerificationProbability`	Yes	The probability of the selfie verification being successful. Possible values: - VeryLow - Low - High - VeryHigh	VeryHigh
`biometricVerification.selfieLivenessOutcome`	Yes	The outcome of the selfie verification. Possible values: - Real - Fake - BadQuality	Real
`biometricVerification.databaseSelfieAvailable`	Yes	Whether the government database had biometrics available for the individual. Also false in some cases biometrics are available but not sufficient for selfie verification.	true
`biometricVerification.selfieSimilarityPercentage`	Yes	Similarity match score of selfie verification. Ranges from 0.0 to 1.0.	0.99