api
Apipe
API Consulta API Facturación API WhatsApp API SMS
v1 — Estable

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.

info

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.

manage_search
Disponible

API Consulta

4 endpoint(s) disponible(s)

Ver endpoints arrow_forward
receipt_long
Próximamente

API Facturación

0 endpoint(s) disponible(s)

chat
Próximamente

API WhatsApp

0 endpoint(s) disponible(s)

sms
Próximamente

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