Documentación
Apipe provee una API REST para consultar información de DNI, RUC y más, directamente desde RENIEC y SUNAT. Todas las respuestas son en formato JSON.
URL base: http://apipe.facturapro.pe/api/v1
Autenticación
Todas las peticiones requieren un token de API en el header
Authorization.
Genera tus tokens en tu panel de control.
curl http://apipe.facturapro.pe/api/v1/ruc/20000000001 \
-H 'Authorization: Bearer tu_token_aqui'
<?php
$response = Http::withToken('tu_token_aqui')
->get('http://apipe.facturapro.pe/api/v1/ruc/20000000001');
$data = $response->json();
const res = await fetch('http://apipe.facturapro.pe/api/v1/ruc/20000000001', {
headers: {
'Authorization': 'Bearer tu_token_aqui'
}
});
const data = await res.json();
Límites de uso
Cada plan tiene un número de consultas mensuales. Al alcanzar el límite recibirás un
429 Too Many Requests.
El contador se resetea automáticamente el 1ro de cada mes.
| Plan | Consultas/mes | Tokens máx. |
|---|---|---|
| Gratuito | 100 | 2 |
| Micro | 2,800 | 3 |
| Básico | 50,000 | 5 |
| Plus | 100,000 | 12 |
| Premium | 250,000 | 24 |
APIs disponibles
Selecciona un grupo para ver la documentación detallada de cada endpoint.
API Facturación
0 endpoint(s) disponible(s)
API WhatsApp
0 endpoint(s) disponible(s)
API SMS
0 endpoint(s) disponible(s)
Códigos de error
Todos los errores retornan "success": false
con un campo message descriptivo.
| Código | Significado |
|---|---|
| 401 | Token inválido o ausente |
| 402 | Suscripción inactiva o vencida |
| 404 | DNI o RUC no encontrado en la fuente |
| 422 | Parámetro con formato inválido |
| 429 | Límite mensual de consultas alcanzado |
| 503 | Servicio SUNAT/RENIEC temporalmente no disponible |