> ## 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.

# Quickstart

> Realiza tu primera consulta a la API de Verifica en 5 minutos

Esta guía te lleva por una primera integración completa: validar los datos de una persona a partir de su número de DNI.

## Prerrequisitos

* Una API key obtenida desde [hub.verifica.id](https://hub.verifica.id) (servicios de consulta) o [prod-hub.verifica.id](https://prod-hub.verifica.id) (firma, KYC y reporte AML).
* Un cliente REST (cURL, Postman o tu librería HTTP preferida).

## Paso 1: Autentícate

Todas las solicitudes se autentican con un token Bearer en formato JWT. Incluye tu API key en el header `Authorization`:

```
Authorization: Bearer YOUR_API_KEY
```

Revisa la sección de [Autenticación](/api-reference/authentication) para conocer de qué plataforma obtener tu token según el servicio.

## Paso 2: Realiza tu primera consulta

Valida los datos de una persona enviando su número de DNI al endpoint de validación de datos.

```bash theme={null}
curl https://api.verifica.id/v2/consulta/personas-ext \
  -H "Authorization: Bearer {TU-API-KEY}" \
  -d dni=87654321
```

## Paso 3: Procesa la respuesta

Si la solicitud es correcta, recibirás los datos de identidad asociados al DNI consultado:

```json theme={null}
{
  "type": "result",
  "status": 200,
  "message": "Se ha validado la información correctamente.",
  "data": {
    "dni": "87654321",
    "verification_digit": "5",
    "given_names": "PABLO ALONSO",
    "paternal_surname": "CARRERA",
    "maternal_surname": "EKUAL",
    "birth_date": "1990-01-16",
    "ubigeo": "140140",
    "gender": "M",
    "underage": false
  }
}
```

## Próximos pasos

<Columns cols={2}>
  <Card title="Autenticación" icon="key" href="/api-reference/authentication">
    Configura la autenticación y obtén tu API key.
  </Card>

  <Card title="Validación de Datos" icon="id-card" href="/api-reference/data-validation/validate-person">
    Explora el endpoint de validación de personas.
  </Card>

  <Card title="FirmaID" icon="pen-nib" href="/api-reference/firmaid/overview">
    Integra flujos de firma digital.
  </Card>

  <Card title="Compliance (AML)" icon="file-shield" href="/api-reference/compliance/aml-report">
    Genera reportes Anti-Lavado de Dinero.
  </Card>
</Columns>

<Note>
  ¿Necesitas ayuda? Escríbenos a [soporte@verifica.id](mailto:soporte@verifica.id).
</Note>
