API de verificación de CPF en Brasil: valida CPF, nombre y fecha de nacimiento

Actualizado en noviembre de 2026

Esta guía muestra cómo verificar CPF en Brasil con la API de Verifik: el endpoint, sus parámetros, una solicitud que puedes pegar en la terminal, la respuesta y los errores documentados, y qué revisar al llevarlo a producción. Todo lo que sigue proviene de la documentación oficial del endpoint.

Sobre el documento: CPF en Brasil

El Cadastro de Pessoas Físicas (CPF) es el registro de contribuyentes personas físicas de Brasil, administrado por la Receita Federal. Un CPF tiene 11 dígitos, los dos últimos son dígitos verificadores, y se escribe como 000.000.000-00. Casi toda relación financiera, de telecomunicaciones o de comercio electrónico en Brasil empieza con un CPF.

El endpoint de Verifik recibe el CPF y la fecha de nacimiento del titular, que deben coincidir, y devuelve el nombre completo, sus partes y la fecha de nacimiento registrada.

Si ya tienes claro el caso de uso, crea una cuenta y prueba el endpoint desde tu código.

Cómo consultar la API de CPF de Brasil

Endpoint: GET https://api.verifik.co/v2/br/cedula. Envía tu token en la cabecera Authorization: Bearer. Parámetros, según la documentación:

Ejemplo de solicitud con valores de ejemplo (reemplázalos por los datos de tu usuario):

curl --location --request GET 'https://api.verifik.co/v2/br/cedula?documentType=CPF&documentNumber=12345678909&dateOfBirth=17/02/2002' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Respuesta 200 de la documentación (datos personales enmascarados):

{
  "data": {
    "arrayName": [
      "R*****",
      "L***",
      "R****",
      "A****",
      "F*******"
    ],
    "dateOfBirth": "2002-**-**",
    "documentNumber": "01*******01",
    "documentType": "CPF",
    "firstName": "R***** L*** R****",
    "fullName": "R***** L*** R**** A**** F*******",
    "lastName": "A**** F*******"
  },
  "signature": {
    "dateTime": "October 8, 2025 6:44 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "AMARG"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: arrayName, dateOfBirth, documentNumber, documentType, firstName, fullName, lastName. Toda respuesta incluye además una signature (fecha y “Certified by Verifik.co”) y un id único que puedes guardar como evidencia de la verificación.

Errores documentados de /v2/br/cedula

• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 403 FORBIDDEN (“Access forbidden”): el token es válido pero no tiene acceso a este endpoint; revisa tu plan o permisos.
• 404 NotFound (“Record not found”): no se encontró registro; no lo trates como coincidencia y envía el caso a revisión o pide otro documento.
• 409 MissingParameter (“missing documentType”): falta un parámetro obligatorio o tiene un valor no válido; corrige la solicitud en vez de reintentarla igual.

Consejos de integración

• Según la documentación, el CPF puede enviarse con o sin separadores. Valida primero los dos dígitos verificadores en tu sistema para no pagar por errores de digitación.
• La fecha de nacimiento es obligatoria y debe coincidir con el registro; envíala como DD/MM/YYYY.
• El tratamiento de datos del CPF está sujeto a la LGPD de Brasil (Ley 13.709/2018). Registra la base legal de la consulta y limita la conservación.
• Si necesitas antecedentes y no una validación de identidad, usa el servicio de antecedentes de Brasil de Verifik en lugar de este endpoint.

Datos personales y términos de uso

Las consultas de identidad tratan datos personales. Usa la API solo con una finalidad legítima que puedas documentar, como onboarding, prevención de fraude o verificación contractual, obtén el consentimiento cuando la ley local lo exija y conserva solo los campos que necesites. El uso se rige por los términos y condiciones de smartCHECK.

Precios

Cada solicitud exitosa consume créditos de tu plan de Verifik. Los planes vigentes y el costo por endpoint están en la página de precios de smartCHECK.

Guías y documentación relacionadas

• API de consulta de CNPJ en Brasil
• API de verificación de DNI argentino
• Documentación del endpoint (español)
• Documentación en inglés

Empieza a probar

Crea una cuenta en Verifik para obtener tu token de API, o agenda una reunión si quieres revisar cobertura y volúmenes con el equipo.