# Documentación DatosPerú API v1

Base: https://api.datosperu.net. Prefijo: /api/v1/.

## Autenticación

Crea una cuenta, verifica tu correo y genera una API Key con permisos. Envía Authorization: Bearer seguido de la clave. No expongas el token en el navegador o en la URL. Las operaciones POST reciben application/json; las GET utilizan parámetros de consulta.

## Respuestas

Éxito: {success: true, data: resultado normalizado, meta: {request_id, timestamp}}. Error: {success: false, error: {code, message}, meta: {request_id, timestamp}}. Los errores previos a la inicialización pueden no incluir meta.

Cada consulta exitosa consume un crédito. Ante errores del proveedor se libera la reserva de cuota. Los límites por minuto son independientes de los créditos del periodo. No asumas cobertura universal ni disponibilidad continua.

## Errores

- HTTP 401: API Key ausente, inválida o revocada. Revisa la credencial.
- HTTP 403: Cuenta, verificación o permiso insuficiente. Revisa tu acceso.
- HTTP 404: Sin resultados o ruta inexistente. Comprueba los datos y el endpoint.
- HTTP 422: Parámetros inválidos. Corrige el cuerpo antes de reintentar.
- HTTP 429: Límite por minuto o cuota del periodo. Revisa el código de error y tu consumo.
- HTTP 502 / 504: Error o demora de la fuente. Reintenta con espera y un máximo de intentos.
- HTTP 503: Servicio no disponible o pendiente de configuración. Consulta el estado.

## Referencia

- [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

[OpenAPI](https://datosperu.net/openapi.json) · [Postman](https://datosperu.net/postman.collection.json) · [Precios](https://datosperu.net/precios)