Know Your Customer
...
Global
Americas

Brazil CPF Fetch

Overview

The Brazil CPF Fetch API is designed to retrieve detailed information associated with a given CPF (Cadastro de Pessoas Físicas) number. This API is tailored for use within Brazil to help verify the identity and registration status of individuals, supporting compliance with local KYC regulations.

Use Case

This API is crucial for a variety of business processes that require reliable identity verification in Brazil, such as:

  • Financial Services: Verifying customer identity during account opening, loan applications, and other banking services.
  • E-commerce: Confirming the identity of customers during checkout to prevent fraudulent transactions.
  • Healthcare: Ensuring patient identity before providing medical services or access to medical records.
  • Insurance: Verifying policyholder information during claims processing and new policy issuance.
  • Employment Background Checks: Confirming the identity of potential hires to ensure they meet hiring criteria.

API Details

Request Body

PreProduction
Production


Request Body Parameters

Parameter

Type

Description

Required

curp

string

The CPF number to fetch details for. Must be 8 to 11 characters long.

Yes

Response Body

Successful Response


Response Body Parameters

Parameter

Type

Description

cpfNumber

String

The CPF number formatted with dots and a dash.

fullName

String

The full legal name of the individual.

dateOfBirth

String

The date of birth of the individual, formatted as YYYY-MM-DD.

registrationStatus

String

Indicates the current status of the CPF (e.g., "REGULAR").

isDeceased

Boolean

Indicates whether the individual is deceased.

transactionResultType

String

The outcome of the API request, typically "Success" or an error description.

Error Code and Response Mapping

400 (Bad Request)
401(Unauthorized)
403 (Forbidden)
500 (Internal Server Error)
409(Upstream Down


Field

Type

Description

name

string

Text displayed on the screen explaining error type.

reason

string

Reason for the error.

status

number

HTTP status code.

message

string

Error message indicating an upstream error.

type

string

Error type.

statusCode

number

Status code representing the error scenario.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!