Skip to main content
POST
Crear match
El Match de Datos RENIEC compara los datos que una persona declaró (nombres, apellidos, fechas de su documento) contra la información oficial de RENIEC, y devuelve un score de similitud de 0 a 100 por cada dato y uno general. No devuelve los datos oficiales: solo cuánto coinciden. Es un proceso en dos pasos: este endpoint crea la validación y devuelve un id; el resultado se obtiene en Consultar match.

Autenticación

¿Todavía no tienes un API token? El campo Authorization del panel Try it espera tu token Bearer. Revisa dónde obtener tu API token para conseguirlo.
Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de Autenticación):

Atributos

dni es obligatorio y debe ir acompañado de al menos uno de los demás campos. Solo se validan los campos que envíes.
string
required
Número de DNI de la persona. 8 dígitos.
string
Nombres de la persona.
string
Apellido paterno.
string
Apellido materno.
string
Apellido de casada, si lo tiene.
string
Dígito de verificación del DNI. Un solo carácter.
string
Fecha de nacimiento, en formato AAAA-MM-DD.
string
Fecha de emisión del DNI, en formato AAAA-MM-DD.
string
Fecha de caducidad del DNI, en formato AAAA-MM-DD.
Las fechas se envían completas. No se aceptan partes sueltas como solo el año: el resultado sí las desglosa en día, mes y año, para que veas cuál de las tres no coincide.

Respuesta

Responde 202: la validación quedó en proceso. La respuesta trae solo lo necesario para consultarla después.
string
success cuando la validación se creó.
string
Mensaje legible del resultado.
object

Ejemplo de Solicitud

Ejemplo de Respuesta Exitosa

Consumo de tokens

Cada validación consume 1 token de tu paquete de Match de Datos RENIEC. El token se reserva al crear y se descuenta cuando la validación termina. Si la validación falla, el token se te devuelve.

Códigos de Error