---
title: "CPF number (alternative)"
method: GET
path: "/services/br/cpf/2/{cpf_number}"
tags: ["🇧🇷 Brazil"]
---

# CPF number (alternative)

`GET /services/br/cpf/2/{cpf_number}`

The alternative Brazil CPF verification service allows you to verify the identity of an individual in Brazil using their individual taxpayer identification number (Cadastro de Pessoas Físicas). The service returns the person’s full name, date of birth, and CPF registration status, including whether the CPF is active, suspended, or cancelled. No document upload is required for verification. This enables quick and automated identity checks against official records.

## Path parameters

- `cpf_number` string, required — Brazilian individual taxpayer identification number (Cadastro de Pessoas Físicas), consisting of 11 numeric digits without formatting (no dots or hyphens)

## Response `200`

**OK**

The request was successful, and our system returned an expected response.

- union
  - object
    - `validation` object
      - `valid` boolean
    - `data` object
      - `cpf_number` string — Brazilian individual taxpayer identification number (Cadastro de Pessoas Físicas), consisting of 11 numeric digits without formatting (no dots or hyphens)
      - `full_name` string, name, nullable — The full name of a person, which includes a first and last name
      - `dob` string, date, nullable — The date of birth of a person, formatted as “YYYY-MM-DD” according to ISO 8601
      - `gender` 'M' | 'F', nullable — The gender of a person. `M` indicates male; `F` indicates female
      - `cpf_status` string — Descriptive status of the CPF number, based on official data. Indicates the current registration condition of the CPF holder - `Regular` — Valid (CPF is active and in good standing) - `Suspensa` — Suspended (CPF is temporarily inactive) - `Cancelada` — Canceled (CPF has been officially canceled) - `Pendente` — Pending regularisation (CPF requires corrective action) - `Nula` — Null (CPF was never issued or is invalid)
      - `cpf_status_code` '00' | '02' | '03' | '04' | '05' | '08' | '09' — Status code of the CPF number, based on official data - `00` — Valid (CPF is active and in good standing) - `02` — Suspended (CPF is temporarily inactive) - `03` — Canceled (CPF has been officially canceled) - `05` — Pending regularisation (CPF requires corrective action) - `08` — Null (CPF was never issued or is invalid)
      - `cpf_status_reason` string — Human-readable reason for the current CPF registration status, as provided by officials. Explains why the CPF holds its specific status (e.g., suspension due to missing tax declarations, cancellation by request, invalid registration, death)
      - `year_of_death` integer, nullable — Calendar year in which the individual was reported deceased, based on available records. The field may be `null` if the information is not applicable
  - object
    - `validation` object
      - `valid` boolean
    - `data` object
      - `cpf_number` string — Brazilian individual taxpayer identification number (Cadastro de Pessoas Físicas), consisting of 11 numeric digits without formatting (no dots or hyphens)
      - `gender` 'M' | 'F', nullable — The gender of a person. `M` indicates male; `F` indicates female
      - `cpf_status` string — Descriptive status of the CPF number, based on official data. Indicates the current registration condition of the CPF holder - `Regular` — Valid (CPF is active and in good standing) - `Suspensa` — Suspended (CPF is temporarily inactive) - `Cancelada` — Canceled (CPF has been officially canceled) - `Pendente` — Pending regularisation (CPF requires corrective action) - `Nula` — Null (CPF was never issued or is invalid)
      - `cpf_status_code` '00' | '02' | '03' | '04' | '05' | '08' | '09' — Status code of the CPF number, based on official data - `00` — Valid (CPF is active and in good standing) - `02` — Suspended (CPF is temporarily inactive) - `03` — Canceled (CPF has been officially canceled) - `05` — Pending regularisation (CPF requires corrective action) - `08` — Null (CPF was never issued or is invalid)
      - `cpf_status_reason` string — Human-readable reason for the current CPF registration status, as provided by officials. Explains why the CPF holds its specific status (e.g., suspension due to missing tax declarations, cancellation by request, invalid registration, death)

## Other responses

- `400` — **Bad Request** Our system could not process the request due to invalid syntax, missing parameters, or incorrect data format. Check the request structure and try again.
- `402` — **Payment Required** Access to the requested resource is restricted until a payment is successfully processed. Ensure your account has a valid payment method or sufficient funds to complete this action.
- `422` — **Unprocessable Content** The request was well-formed but contains invalid or unprocessable data, such as failed validation or incorrect field values.
- `500` — **Internal Server Error** This response indicates that our system encountered an unexpected condition that prevented it from fulfilling the request.
- `502` — **Bad Gateway** This response indicates that our system is unable to reach or communicate properly with an upstream server it relies on, the URL provided is incorrect, or a required token is missing from the request.

---

[API](https://skmtc.net/kycaid/apis/overview.md) · [All operations](https://skmtc.net/kycaid/apis/overview/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kycaid/overview/versions/971fdaeccced/schema)