> ## Documentation Index
> Fetch the complete documentation index at: https://developers.verifica.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar match

> Obtén el resultado de un Match de Datos RENIEC: score general y por campo

Devuelve el estado de una validación creada en [Crear match](/api-reference/match-reniec/create-match) y, cuando termina, su resultado.

La validación suele resolverse en pocos segundos, pero puede tardar más si RENIEC se demora. Mientras siga en `pending`, vuelve a consultar cada pocos segundos.

## Autenticación

<Note>
  **¿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](/api-reference/authentication#dónde-obtener-tu-api-token) para conseguirlo.
</Note>

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](/api-reference/authentication)):

```
Authorization: Bearer YOUR_API_KEY
```

## Atributos Requeridos

<ParamField path="id" type="string" required>
  Identificador devuelto al crear el match.
</ParamField>

## Respuesta

Responde `200` en cualquier estado.

<ResponseField name="status" type="string">
  `success` cuando la consulta se resolvió.
</ResponseField>

<ResponseField name="message" type="string">
  Mensaje legible del resultado.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="propiedades de data">
    <ResponseField name="id" type="string">
      Identificador de la validación.
    </ResponseField>

    <ResponseField name="dni" type="string">
      DNI validado.
    </ResponseField>

    <ResponseField name="status" type="string">
      `pending` mientras se valida, `completed` cuando hay resultado, o `failed` si la validación no pudo completarse.
    </ResponseField>

    <ResponseField name="score" type="number | null">
      Score general de 0 a 100, con dos decimales. Es el promedio de los campos que enviaste: una fecha cuenta como un solo campo. Solo con `completed`.
    </ResponseField>

    <ResponseField name="result" type="object | null">
      Un objeto por cada campo que enviaste, con su `score` de 0 a 100. Solo con `completed`.

      <Expandable title="campos de fecha">
        Las fechas (`birth_date`, `issue_date`, `expiration_date`) traen su `score`, que es el promedio de sus partes, y dentro de `parts` el score de `day`, `month` y `year` por separado. Así ves exactamente qué parte no coincide.
      </Expandable>
    </ResponseField>

    <ResponseField name="error" type="object | null">
      Solo con `failed`: un objeto con `message` describiendo el motivo. El token de esa validación se te devuelve.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Fecha de creación, en ISO 8601.
    </ResponseField>

    <ResponseField name="completed_at" type="string | null">
      Fecha en que la validación terminó, en ISO 8601.
    </ResponseField>
  </Expandable>
</ResponseField>

## Ejemplo de Solicitud

```bash theme={null}
curl --request GET \
  --url 'https://prd-api.verifica.id/api/v1/solutions/match-reniec/01a0f583-2f28-72df-835c-b88bd647d92e' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {TU-API-KEY}'
```

## Ejemplo de Respuesta Exitosa

Validación completada. Los nombres coinciden por completo; en la fecha de nacimiento coinciden el mes y el año pero no el día, así que la fecha queda en 66.67 y el score general en 83.33.

```json theme={null}
{
  "status": "success",
  "message": "Retrieve match.",
  "data": {
    "id": "01a0f583-2f28-72df-835c-b88bd647d92e",
    "dni": "12345678",
    "status": "completed",
    "score": 83.33,
    "result": {
      "names": { "score": 100 },
      "birth_date": {
        "score": 66.67,
        "parts": {
          "day": { "score": 0 },
          "month": { "score": 100 },
          "year": { "score": 100 }
        }
      }
    },
    "error": null,
    "created_at": "2026-09-30T22:30:10-05:00",
    "completed_at": "2026-09-30T22:30:13-05:00"
  }
}
```

## Ejemplo de Respuesta en Proceso

La validación todavía no termina: vuelve a consultar en unos segundos.

```json theme={null}
{
  "status": "success",
  "message": "Retrieve match.",
  "data": {
    "id": "01a0f583-2f28-72df-835c-b88bd647d92e",
    "dni": "12345678",
    "status": "pending",
    "score": null,
    "result": null,
    "error": null,
    "created_at": "2026-09-30T22:30:10-05:00",
    "completed_at": null
  }
}
```

## Cómo interpretar el score

El score indica qué tan parecido es el dato que enviaste al registrado en RENIEC, de 0 (no coincide) a 100 (coincide por completo). Como referencia, un campo con **más de 90** puede considerarse válido. Define en tu sistema los umbrales que apliquen a tu proceso: el servicio no decide por ti si la persona se aprueba o se rechaza.

## Códigos de Error

| Código | Descripción |
| - | - |
| 401 | Token de autenticación inválido o faltante |
| 404 | La validación no existe o no pertenece a tu cuenta |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.