Inicio

Todo lo que necesitas saber antes de hacer tu primera consulta.

URL base

Todos los endpoints de esta referencia son relativos a una URL base. Hay dos formas válidas de llegar a la API — ambas sirven exactamente las mismas rutas, elige la que prefieras:

URL base	Notas
`https://api.apiconsulta.xmlapi.pe`	Subdominio dedicado a la API. Recomendado — URL más corta, sin el `/api` de en medio.
`https://apiconsulta.xmlapi.pe`	Dominio principal (compartido con el sitio web). Sigue funcionando indefinidamente — es la forma en que ya te estás conectando si empezaste antes de que existiera el subdominio dedicado. Aquí antepones `/api` a la ruta de cada endpoint (así ya lo hacen los sistemas existentes).

Un endpoint como /dni en esta documentación se arma pegando la URL base que elijas + la ruta del endpoint, por ejemplo:

https://api.apiconsulta.xmlapi.pe/dni
https://apiconsulta.xmlapi.pe/api/dni

(mismo endpoint, misma respuesta — solo cambia el host, y si va o no el /api). Los ejemplos de código de cada endpoint (cURL, PHP, JavaScript, Python) en esta referencia usan https://api.apiconsulta.xmlapi.pe — si prefieres la URL legacy, cambia esa parte y agrega /api antes de la ruta del endpoint.

Autenticación

Todas las peticiones requieren un token en el header Authorization:

Authorization: Bearer TU_TOKEN

Genera tu token desde el panel, en Api Tokens.

Colección de Postman

Descarga la colección con los endpoints ya armados (variables URL_BASE y TOKEN incluidas — solo configúralas una vez en Postman y quedan aplicadas a toda la colección). Hay dos:

ApiPeruDev — solo lo que ves en esta referencia.
ApiPeruDev — Completa — suma PSE, OSE, catálogos SUNAT, descarga directa de CPE y las variantes internas (estas últimas requieren un token de usuario superadmin).

Descargar colección Descargar colección completa