API RUC/DNI Perú

Consulta de RUC (SUNAT) y DNI (RENIEC) para desarrolladores, con caché y créditos gratuitos para empezar.

100 créditos gratis al registrarte. Cada consulta nueva cuesta 1 crédito; si ya consultamos ese RUC/DNI en las últimas 24h, la respuesta es gratis (desde caché).

1. Crear tu cuenta

Registrate con tu nombre y correo. La respuesta incluye tu API key — guardala, no se vuelve a mostrar.

curl -X POST https://api.facturamelo.org.pe/auth/register \
  -H "Content-Type: application/json" \
  -d '{"name": "Tu Nombre", "email": "tu@correo.com"}'

2. Consultar un RUC

curl https://api.facturamelo.org.pe/v1/ruc/20416074161 \
  -H "Authorization: Bearer TU_API_KEY"

{
  "success": true,
  "data": {
    "numero_documento": "20416074161",
    "razon_social": "AMERICAN RENTA CAR S.A.C.",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "direccion": "JR. ENRIQUE ENCINAS FRANCO NRO 240...",
    "departamento": "LIMA", "provincia": "LIMA", "distrito": "LA VICTORIA"
  },
  "cached": false
}

3. Consultar un DNI

curl https://api.facturamelo.org.pe/v1/dni/40452058 \
  -H "Authorization: Bearer TU_API_KEY"

4. Ver tu consumo

curl https://api.facturamelo.org.pe/account/usage \
  -H "Authorization: Bearer TU_API_KEY"

Códigos de respuesta

Código	Significado
200	OK — dato encontrado
401	Token faltante, inválido o revocado
402	Sin créditos disponibles
404	RUC/DNI no encontrado
422	Formato de número inválido
429	Límite de 30 solicitudes por minuto excedido

Límites

30 solicitudes por minuto por API key.

Planes

Plan	Precio	Créditos
Free	S/ 0 (al registrarte)	100
Starter	S/ 10	1,500
Pro	S/ 25	6,000
Business	S/ 60	20,000

Para recargar créditos, escribinos por WhatsApp con tu comprobante Yape/BCP y el correo de tu cuenta.