# DatosPerú

> API REST privada de consultas de datos en Perú: DNI, RUC, consultas SUNAT, vehículos, recibos y finanzas. 25 endpoints, JSON y autenticación Bearer.

Sitio canónico: https://datosperu.net. API de producción: https://api.datosperu.net. Las consultas se realizan a través del proveedor JSON.pe. DatosPerú es independiente de SUNAT y RENIEC; no ofrece emisión de comprobantes ni certificación de identidad. La cobertura y disponibilidad dependen de la fuente. Las consultas requieren una cuenta verificada, API Key con permisos y datos cuyo tratamiento esté autorizado. Una consulta exitosa consume un crédito; hay cuotas de periodo y límites de frecuencia. Los ejemplos no son datos de producción. Consulta Precios para condiciones vigentes.

## Empieza aquí
- [Documentación general](https://datosperu.net/docs.md): autenticación, rutas y respuestas.
- [OpenAPI 3.1](https://datosperu.net/openapi.json): contrato importable con entradas, respuestas y errores de las 25 operaciones.
- [Precios](https://datosperu.net/precios): planes y condiciones publicadas.
- [Colección Postman](https://datosperu.net/postman.collection.json): importación sin credenciales incrustadas.

## APIs
- [API DNI Perú: consulta de identidad en JSON](https://datosperu.net/api-dni.md): alcance y limitaciones.
- [API RUC Perú: razón social, estado y domicilio fiscal](https://datosperu.net/api-ruc.md): alcance y limitaciones.
- [API SUNAT: consulta RUC, CPE y guías de remisión](https://datosperu.net/api-sunat.md): alcance y limitaciones.
- [API tipo de cambio: compra y venta por fecha](https://datosperu.net/api-tipo-cambio.md): alcance y limitaciones.
- [API consulta de placa vehicular en Perú](https://datosperu.net/api-placa.md): alcance y limitaciones.
- [API SOAT: consulta de seguro vehicular por placa](https://datosperu.net/api-soat.md): alcance y limitaciones.
- [API recibos: Luz del Sur y Sedapal por suministro](https://datosperu.net/api-recibos.md): alcance y limitaciones.
- [API CPE: consulta de comprobantes electrónicos SUNAT](https://datosperu.net/api-cpe.md): alcance y limitaciones.

## Referencia de endpoints
- [Consulta DNI](https://datosperu.net/docs/dni.md): POST /api/v1/dni.
- [Carnet de extranjería](https://datosperu.net/docs/ce.md): POST /api/v1/ce.
- [Cédula de identidad](https://datosperu.net/docs/ci.md): POST /api/v1/ci.
- [DNI → RUC](https://datosperu.net/docs/dni-ruc.md): POST /api/v1/dni-ruc.
- [Licencia de conducir](https://datosperu.net/docs/licencia.md): POST /api/v1/licencia.
- [Consulta RUC](https://datosperu.net/docs/ruc.md): POST /api/v1/ruc.
- [Representantes legales](https://datosperu.net/docs/ruc/representantes.md): POST /api/v1/ruc/representantes.
- [Establecimientos](https://datosperu.net/docs/ruc/establecimientos.md): POST /api/v1/ruc/establecimientos.
- [Domicilio fiscal](https://datosperu.net/docs/ruc/domicilio-fiscal.md): POST /api/v1/ruc/domicilio-fiscal.
- [Deuda coactiva](https://datosperu.net/docs/ruc/deuda-coactiva.md): POST /api/v1/ruc/deuda-coactiva.
- [Trabajadores](https://datosperu.net/docs/ruc/trabajadores.md): POST /api/v1/ruc/trabajadores.
- [Omisiones tributarias](https://datosperu.net/docs/ruc/omisiones.md): POST /api/v1/ruc/omisiones.
- [Razón social](https://datosperu.net/docs/ruc/razon-social.md): POST /api/v1/ruc/razon-social.
- [Consulta CPE](https://datosperu.net/docs/sunat/cpe.md): POST /api/v1/sunat/cpe.
- [Descargar XML](https://datosperu.net/docs/sunat/xml.md): POST /api/v1/sunat/xml.
- [XML a PDF](https://datosperu.net/docs/sunat/xml-pdf.md): POST /api/v1/sunat/xml-pdf.
- [Guía XML](https://datosperu.net/docs/sunat/guia/xml.md): GET /api/v1/sunat/guia/xml.
- [Guía JSON](https://datosperu.net/docs/sunat/guia/json.md): GET /api/v1/sunat/guia/json.
- [Consulta por placa](https://datosperu.net/docs/vehiculo/placa.md): POST /api/v1/vehiculo/placa.
- [SOAT por placa](https://datosperu.net/docs/soat.md): POST /api/v1/soat.
- [Revisión técnica](https://datosperu.net/docs/vehiculo/revision-tecnica.md): POST /api/v1/vehiculo/revision-tecnica.
- [Tipo de cambio](https://datosperu.net/docs/tipo-cambio.md): POST /api/v1/tipo-cambio.
- [Comisiones AFP](https://datosperu.net/docs/afp.md): POST /api/v1/afp.
- [Luz del Sur](https://datosperu.net/docs/recibos/luz-del-sur.md): POST /api/v1/recibos/luz-del-sur.
- [Sedapal](https://datosperu.net/docs/recibos/sedapal.md): POST /api/v1/recibos/sedapal.

## Guías
- [Integrar API RUC y DNI en PHP con cURL](https://datosperu.net/guias/integrar-api-php.md): Guía PHP para consultar RUC o DNI con DatosPerú. Variables de entorno, token Bearer, JSON y manejo de errores HTTP.
- [API DNI y RUC con Node.js: fetch y TypeScript](https://datosperu.net/guias/integrar-api-nodejs.md): Conecta DatosPerú desde Node.js con fetch, token Bearer, timeout y validación de respuestas. Ejemplo listo para adaptar a tu servidor.
- [Consultar API RUC y DNI con Python](https://datosperu.net/guias/integrar-api-python.md): Ejemplo Python de consulta RUC con urllib, JSON y token Bearer. Aprende a validar entradas y controlar errores sin exponer tu API Key.
- [Formulario HTML para consultar DNI y RUC con API](https://datosperu.net/guias/integrar-api-html.md): Descarga un formulario HTML y un proxy Node.js para consultar DNI y RUC. La API Key permanece en el servidor, fuera del JavaScript público.
- [Nodo HTTP Request de n8n para API DNI y RUC](https://datosperu.net/guias/integrar-api-n8n.md): Importa un workflow de n8n para consultar RUC con DatosPerú. Configura Header Auth, cuerpo JSON y manejo de errores sin compartir tu API Key.
- [Cómo elegir una API DNI, RUC o SUNAT para tu sistema](https://datosperu.net/guias/elegir-api-dni-ruc.md): Compara APIs de Perú por cobertura, contrato, consumo, errores e integración. Una guía práctica para evaluar un proveedor sin depender de promesas.

## Optional
- [Documentación completa en Markdown](https://datosperu.net/llms-full.txt): contenido ampliado en un archivo.
- [Sobre DatosPerú](https://datosperu.net/acerca-de): proveedor, alcance e independencia.
- [Contacto](https://datosperu.net/contacto): soporte@wazend.net.
- [Términos](https://datosperu.net/terminos): revisar el estado del documento.
- [Privacidad](https://datosperu.net/privacidad): tratamiento de datos y estado del documento.