Autenticación

Los endpoints de consulta (DNI, RUC, tipo de cambio, CDR, etc.) usan un token personal de API.

Activación de la cuenta y token

Al registrarte recibes dos correos:

Bienvenida: tus datos de acceso, el plan con el que arrancas y un botón para confirmar tu correo. Este correo no trae token.
Cuenta verificada: se envía apenas confirmas tu correo. Trae tu token de API, el plan al que te afiliaste y cuántas consultas tienes para probar.

Hasta que confirmes tu correo, el token no responde: no verás el token en /mi-cuenta y cualquier consulta responde 403 con el mensaje "Confirma tu correo para activar este token". Si no te llegó el correo, puedes reenviarlo desde tu panel.

Token de API

Envíalo en la cabecera Authorization con el prefijo Bearer:

curl https://mblapirest.com/api/v1/dni/12345678 \
  -H "Authorization: Bearer TU_API_TOKEN"

Si tu token se filtró o quieres rotarlo, usa Regenerar mi token (POST /cuenta/regenerar-token) — el anterior deja de funcionar de inmediato.

Cuota de consultas

Tu plan trae una cantidad de consultas al mes, y vale para cualquiera de los servicios que tengas habilitados: DNI, RUC (incluido RUC completo), tipo de cambio, SIRE, CDR, etc. Todas descuentan de la misma bolsa.

Se descuenta	No se descuenta
Una consulta que respondió con datos.	Errores de SUNAT (`502`) y validaciones de parámetros.
Cada paso exitoso del flujo SIRE (periodos, ticket, propuesta, detalle).	La respuesta "el ticket sigue en proceso en SUNAT" de SIRE: es la misma petición esperando, así que puedes consultar cada pocos segundos sin gastar cuota.

Si ya agotaste la cuota, la API corta antes de consultar a SUNAT y responde success: false (ver tabla de abajo).

Errores de autenticación

Código	Motivo
401	Token inválido, inexistente, cuenta suspendida o vencida.
403	Tu plan no tiene habilitado ese servicio en particular, o tu correo aún no está confirmado.
200 (success:false)	Superaste la cuota de consultas de tu plan, o error de validación del propio request (p. ej. DNI mal formado).

Circuito Facturador (B2B)

Las integraciones bajo /licenses/* (ver Facturador) usan un esquema distinto: cabeceras License-Id y License-Secret, entregadas al crear la integración.

Última actualización: 02/10/2026