Skip to main content
GET
Get a person by CPF
The data comes from Brazil’s public registries, looked up in real time: a person read in the last 7 days is answered from the registry’s copy, otherwise it is looked up again before the answer is sent. It is the same for every organization — nothing in it belongs to yours. A document that is not a valid CPF is answered as not found, like one the registry doesn’t have. When the source refuses to answer for a CPF, the answer is PERSON_LOOKUP_RESTRICTED, without a reason.

Path Parameters

realmId
string<uuid>
required

ID of your realm.

Format: UUID

organizationId
string<uuid>
required

ID of the organization making the request.

Format: UUID

document
string
required

CPF of the person: 11 digits. Dots, dashes and spaces are ignored.

Response

Successful response

A person, by CPF. Text comes in upper case, as the registry publishes it.

document
string
required

CPF of the person, 11 digits.

Example:

"52998224725"

name
string

Full name.

Example:

"MARIA EXEMPLO DA SILVA"

socialName
string

Social name, when the person registered one.

Example:

"MARIA EXEMPLO"

gender
enum<string>

MALE or FEMALE.

Available options:
MALE,
FEMALE
Example:

"FEMALE"

birthDate
string<date-time>

Date of birth.

Example:

"1984-09-17T00:00:00.000Z"

nationality
string

Nationality, as published.

Example:

"BRASILEIRA"

motherName
string

Mother's name.

Example:

"ANA EXEMPLO DA SILVA"

fatherName
string

Father's name.

Example:

"JOSE EXEMPLO DA SILVA"

maritalStatus
string

Marital status, as published.

Example:

"CASADO"

maritalStatusUpdatedAt
string<date-time>

When the marital status was last updated at the source.

Example:

"2019-05-02T00:00:00.000Z"

taxIdStatus
enum<string>

Status of the CPF at Receita Federal: REGULAR, PENDING_REGULARIZATION, SUSPENDED, CANCELED, ANNULLED, HOLDER_DECEASED or INCOMPLETE_DATA.

Available options:
REGULAR,
PENDING_REGULARIZATION,
SUSPENDED,
CANCELED,
ANNULLED,
HOLDER_DECEASED,
INCOMPLETE_DATA
Example:

"REGULAR"

taxIdStatusDate
string<date-time>

When the CPF status was last checked at Receita Federal.

Example:

"2026-10-01T00:00:00.000Z"

taxIdRegistrationDate
string<date-time>

When the CPF was registered.

Example:

"2001-03-15T00:00:00.000Z"

taxIdFiscalRegion
string

Receita Federal fiscal region of the CPF.

Example:

"SP"

deceased
boolean

Whether there is a record of the person's death.

Example:

false

deathYear
string

Year of death, when deceased is true.

Example:

"2021"

createdAt
string<date-time>

When this person was first added to the registry.

Example:

"2026-10-29T15:00:00.000Z"

updatedAt
string<date-time>

When this record last changed.

Example:

"2026-10-29T15:00:00.000Z"