Consulta Perú

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.

Tipo de cambio SBS

Consulta el tipo de cambio USD oficial de la SBS. Datos históricos por fecha, actualizados diariamente.

Validación de CPE

Verifica facturas, boletas y notas de crédito/débito electrónicas directamente en SUNAT. Estado ACEPTADO, ANULADO y más.

Cómo funciona

Listo en menos de 5 minutos

1

Crea tu cuenta

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

2

Obtén tu API Key

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

3

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
}

tipo_cambio.sh

# Consulta el tipo de cambio de hoy
curl -X GET \
  "https://api.consultaperuapi.com/api/v1/tipo-cambio?token=tu_api_key"

# O enviando token y fecha en el body
curl -X GET \
  "https://api.consultaperuapi.com/api/v1/tipo-cambio" \
  -H "Content-Type: application/json" \
  -d '{"token": "tu_api_key", "fecha": "2026-04-17"}'

# Respuesta
{
  "fecha": "2025-01-15",
  "moneda": "USD",
  "compra": 3.710,
  "venta": 3.715,
  "fuente": "SBS"
}

tipo_cambio.py

import requests

# Configura tu API Key
API_KEY = "tu_api_key"

# Tipo de cambio de hoy
response = requests.get(
    "https://api.consultaperuapi.com/api/v1/tipo-cambio",
    params={"token": API_KEY}
)

data = response.json()
print(data["compra"])  # 3.71
print(data["venta"])   # 3.715
print(data["fecha"])   # "2025-01-15"

tipo_cambio.js

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

// Tipo de cambio de hoy
const response = await fetch(
  `https://api.consultaperuapi.com/api/v1/tipo-cambio?token=${API_KEY}`
);

const data = await response.json();
console.log(data.compra);  // 3.71
console.log(data.venta);   // 3.715
console.log(data.fecha);   // "2025-01-15"

tipo_cambio.php

<?php

// Configura tu API Key
$apiKey = "tu_api_key";
$url    = "https://api.consultaperuapi.com/api/v1/tipo-cambio?token=" . $apiKey;
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPGET        => true,
]);

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

echo $data->compra;  // 3.71
echo $data->venta;   // 3.715
echo $data->fecha;   // "2025-01-15"

validar_cpe.sh

# Valida un comprobante electrónico en SUNAT
curl -X POST \
  "https://api.consultaperuapi.com/api/v1/cpe/consultar" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "tu_api_key",
    "ruc": "20601138572",
    "tipo": "01",
    "serie": "F001",
    "correlativo": "1234",
    "fecha": "2026-01-15",
    "monto": 1180.00
  }'

# Respuesta
{
  "valido": true,
  "ruc_emisor": "20601138572",
  "descripcion_tipo": "Factura",
  "serie": "F001",
  "correlativo": "1234",
  "fecha_emision": "2026-01-15",
  "monto_total": 1180,
  "estado": "ACEPTADO",
  "estado_contribuyente": "ACTIVO",
  "fuente": "SUNAT"
}

validar_cpe.py

import requests

API_KEY = "tu_api_key"

response = requests.post(
    "https://api.consultaperuapi.com/api/v1/cpe/consultar",
    json={
        "token": API_KEY,
        "ruc": "20601138572",
        "tipo": "01",
        "serie": "F001",
        "correlativo": "1234",
        "fecha": "2026-01-15",
        "monto": 1180.00
    }
)

data = response.json()
print(data["valido"])         # True
print(data["estado"])         # "ACEPTADO"
print(data["descripcion_tipo"])  # "Factura"

validar_cpe.js

const API_KEY = "tu_api_key";

const response = await fetch(
  "https://api.consultaperuapi.com/api/v1/cpe/consultar",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      token: API_KEY,
      ruc: "20601138572",
      tipo: "01",
      serie: "F001",
      correlativo: "1234",
      fecha: "2026-01-15",
      monto: 1180.00
    })
  }
);

const data = await response.json();
console.log(data.valido);         // true
console.log(data.estado);         // "ACEPTADO"
console.log(data.descripcion_tipo);  // "Factura"

validar_cpe.php

<?php

$apiKey = "tu_api_key";
$payload = [
    "token"      => $apiKey,
    "ruc"        => "20601138572",
    "tipo"       => "01",
    "serie"      => "F001",
    "correlativo"=> "1234",
    "fecha"      => "2026-01-15",
    "monto"      => 1180.00
];

$ch = curl_init("https://api.consultaperuapi.com/api/v1/cpe/consultar");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS     => json_encode($payload)
]);

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

echo $data->valido ? "Válido" : "No válido";
echo $data->estado;          // "ACEPTADO"
echo $data->descripcion_tipo; // "Factura"

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

100 consultas/mes

✓ 100 consultas mensuales
✓ Generación de 1 token para desarrollo
✓ 2 req/seg (rate limit)
✓ Consulta de (RUC + DNI)
✓ Documentación y ejemplos

Empezar gratis

Starter

S/. 19 /mes

✓ Consultas ilimitadas
✓ Generación de 3 tokens para consultas
✓ 10 req/seg (rate limit)
✓ Consulta de (RUC + DNI)
✓ Consulta de tipo de cambio SBS
✓ Consulta de Validación CPE
✓ Documentación y ejemplos

Suscribirse al Starter

Popular

Pro

S/. 35 /mes

✓ Consultas ilimitadas
✓ Generación de múltiples tokens para consulta
✓ 30 req/seg (rate limit)
✓ Consulta de (RUC + DNI)
✓ Consulta de tipo de cambio SBS
✓ Consulta de Validación CPE
✓ Consultas en lote (batch)
✓ Historial exportable (CSV)
✓ Documentación y ejemplos
✓ Soporte virtual para implementación

Suscribirse al Pro

Cancela en cualquier momento

Blog

Recursos y tutoriales

Guías de integración, casos de uso y novedades sobre la API.

Ver todos los artículos →

Empieza a consultar el padrón SUNAT hoy

Crea tu cuenta gratis y realiza tus primeras 100 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 y muchos más...

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

Tipo de cambio SBS

Validación de CPE

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

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 y muchos más...