Padrón SUNAT actualizado

Consulta el RUC o DNI de cualquier
contribuyente peruano

API REST simple y rápida para integrar consultas al padrón tributario de SUNAT en tus aplicaciones. Sin complicaciones, sin burocracia.

Comenzar → Ver cómo funciona

Plan gratuito incluye 500 consultas/mes · Sin tarjeta de crédito

consulta_ruc.sh

# Consulta un RUC con tu API key
curl -X POST "https://api.consultaperuapi.com/api/v1/consultas" \
  -H "Content-Type: application/json" \
  -d '{"token": "tu_api_key", "ruc": "20601138572"}'

# Respuesta
{
  "ruc": "20601138572",
  "razon_social": "EMPRESA EJEMPLO S.A.C.",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "ubigeo": "150101"
}

Características

Todo lo que necesitas para validar contribuyentes

Consulta por RUC

Obtén razón social, estado, condición, domicilio fiscal y más datos del padrón SUNAT al instante.

Consulta por DNI

Valida identidades buscando en el padrón SUNAT. Obtén nombres, apellidos y dirección al instante.

Autenticación segura

API Keys únicas por cuenta con control de cuotas y acceso restringido a tus sistemas.

Respuesta en milisegundos

Infraestructura optimizada para respuestas bajo 200ms. Sin timeouts inesperados en producción.

Dashboard de uso

Monitorea tus consultas en tiempo real, historial detallado y métricas de uso desde tu panel.

Integración sencilla

Una sola línea de código en cualquier lenguaje. Compatible con Python, Node.js, PHP, Java y más.

Cómo funciona

Listo en menos de 5 minutos

Crea tu cuenta

Regístrate gratis. Sin tarjeta de crédito. Tu cuenta se activa al instante.

Obtén tu API Key

Desde tu dashboard, genera tu API Key en un clic. Es única y segura para tu cuenta.

Empieza a consultar

Haz tu primera consulta con un simple POST request. Respuesta JSON en menos de 200ms.

Guía de integración

Ejemplos de código

Integra la API en tu lenguaje favorito en minutos.

Endpoint

POST /api/v1/consultas

Body: {"token": "TU_API_KEY", "ruc": "20601138572"}

consulta.sh

# Consulta un RUC
curl -X POST \
  "https://api.consultaperuapi.com/api/v1/consultas" \
  -H "Content-Type: application/json" \
  -d '{"token": "tu_api_key", "ruc": "20601138572"}'

# Respuesta
{
  "ruc": "20601138572",
  "razon_social": "EMPRESA EJEMPLO S.A.C.",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "ubigeo": "150101"
}

consulta.sh

# Consulta un DNI
curl -X POST \
  "https://api.consultaperuapi.com/api/v1/consultas-dni" \
  -H "Content-Type: application/json" \
  -d '{"token": "tu_api_key", "dni": "12345678"}'

# Respuesta
{
  "success": true,
  "data": {
    "dni": "12345678",
    "nombres": "JUAN PABLO",
    "apellidoPaterno": "GARCÍA",
    "nombreCompleto": "GARCÍA PÉREZ JUAN PABLO",
    "direccion": "JR. EJEMPLO 456",
    "fuente": "padron_local"
  }
}

consulta.py

import requests

# Configura tu API Key
API_KEY = "tu_api_key"
RUC = "20601138572"

response = requests.post(
    "https://api.consultaperuapi.com/api/v1/consultas",
    json={"token": API_KEY, "ruc": RUC}
)

data = response.json()
print(data["razon_social"])  # "EMPRESA EJEMPLO S.A.C."
print(data["estado"])       # "ACTIVO"

consulta_dni.py

import requests

# Configura tu API Key
API_KEY = "tu_api_key"
DNI = "12345678"

response = requests.post(
    "https://api.consultaperuapi.com/api/v1/consultas-dni",
    json={"token": API_KEY, "dni": DNI}
)

data = response.json()
if data["success"]:
    print(data["data"]["nombreCompleto"])  # Nombre completo
    print(data["data"]["direccion"])           # Dirección

consulta.js

// Configura tu API Key
const API_KEY = "tu_api_key";
const ruc = "20601138572";

const response = await fetch(
  "https://api.consultaperuapi.com/api/v1/consultas",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ token: API_KEY, ruc })
  }
);

const data = await response.json();
console.log(data.razon_social);  // "EMPRESA EJEMPLO S.A.C."
console.log(data.estado);        // "ACTIVO"

consulta_dni.js

// Configura tu API Key
const API_KEY = "tu_api_key";
const dni = "12345678";

const response = await fetch(
  "https://api.consultaperuapi.com/api/v1/consultas-dni",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ token: API_KEY, dni })
  }
);

const data = await response.json();
if (data.success) {
  console.log(data.data.nombreCompleto);  // Nombre completo
  console.log(data.data.direccion);           // Dirección
}

consulta.php

<?php

// Configura tu API Key
$apiKey = "tu_api_key";
$ruc    = "20601138572";
$ch = curl_init("https://api.consultaperuapi.com/api/v1/consultas");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS     => json_encode(["token" => $apiKey, "ruc" => $ruc])
]);

$body = curl_exec($ch);
$data = json_decode($body);

echo $data->razonSocial;  // "EMPRESA EJEMPLO S.A.C."
echo $data->estado;       // "ACTIVO"

consulta_dni.php

<?php

// Configura tu API Key
$apiKey = "tu_api_key";
$dni    = "12345678";
$ch = curl_init("https://api.consultaperuapi.com/api/v1/consultas-dni");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS     => json_encode(["token" => $apiKey, "dni" => $dni])
]);

$body = curl_exec($ch);
$data = json_decode($body);

if ($data->success) {
    echo $data->data->nombreCompleto;  // Nombre completo
    echo $data->data->direccion;           // Dirección
}

Campos de la respuesta

ruc

Número de RUC del contribuyente (11 dígitos)

razonSocial

Nombre o razón social registrada en SUNAT

estado

Estado del contribuyente: ACTIVO, BAJA, etc.

condicion

Condición de domicilio: HABIDO, NO HABIDO, etc.

direccion

Domicilio fiscal registrado

ubigeo

Ubicación geográfica: Departamento, Provincia, Distrito

Precios

Simple y transparente

Sin costos ocultos. Cancela cuando quieras.

Free

Gratis

500 consultas/mes

✓ 500 consultas mensuales
✓ 2 req/seg (rate limit)
✓ POST /ruc/{ruc} o POST /dni/{dni}

Empezar gratis

Starter

S/. 19 /mes

✓ Consultas ilimitadas
✓ 10 req/seg (rate limit)
✓ POST /ruc/{ruc} o POST /dni/{dni}
✓ Datos completos del RUC y DNI
✓ Documentación y ejemplos
✓ Endpoints futuros (B/L, TC, etc.)

Suscribirse al Starter

Popular

Pro

S/. 35 /mes

✓ Consultas ilimitadas
✓ 30 req/seg (rate limit)
✓ POST /ruc/{ruc} o POST /dni/{dni}
✓ Datos completos del RUC y DNI
✓ Documentación y ejemplos
✓ Consulta por DNI (padrón local + fallback)
✓ Endpoints futuros (B/L, TC, etc.)
✓ Soporte virtual para implementación

Suscribirse al Pro

Cancela en cualquier momento

Empieza a consultar el padrón SUNAT hoy

Crea tu cuenta gratis y realiza tus primeras 500 consultas sin costo. Sin tarjeta de crédito requerida.

Crear cuenta gratis →

Plan gratuito · Sin límite de tiempo · Sin tarjeta de crédito

Consulta el RUC o DNI de cualquier contribuyente peruano

Todo lo que necesitas para validar contribuyentes

Consulta por RUC

Consulta por DNI

Autenticación segura

Respuesta en milisegundos

Dashboard de uso

Integración sencilla

Listo en menos de 5 minutos

Crea tu cuenta

Obtén tu API Key

Empieza a consultar

Ejemplos de código

Campos de la respuesta

Campos de la respuesta

Simple y transparente

Recursos y tutoriales

Empieza a consultar el padrón SUNAT hoy

Consulta el RUC o DNI de cualquier
contribuyente peruano