Inicio rápido

Crea tu cuenta, genera una clave y consulta tu primer RUC.

1. Crea tu cuenta

Regístrate con tu correo y confírmalo con el enlace que te enviamos. Al confirmarlo se activa el plan Gratis: 1 000 consultas cada mes.

2. Genera una clave

En el panel, entra a Claves y crea una. La verás una sola vez: cópiala y guárdala como cualquier secreto (en una variable de entorno, nunca en el código de una web o una app móvil).

Hay dos tipos:

• wk_live_…: datos reales, gasta cuota.
• wk_test_…: datos de ejemplo fijos, no gasta cuota. Ideal para pruebas automáticas. Responde a 20131312955, 20100047218 y 10000000001.

3. Consulta

curl https://api.peru.winkstec.com/v1/ruc/20131312955 \
  -H "Authorization: Bearer wk_live_TU_CLAVE"

Respuesta:

{
  "ruc": "20131312955",
  "razonSocial": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA - SUNAT",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "direccion": "AV. GARCILASO DE LA VEGA NRO. 1472",
  "ubigeo": "150101",
  "departamento": "LIMA",
  "provincia": "LIMA",
  "distrito": "LIMA",
  "tipo": "persona_juridica",
  "fechaPadron": "2026-10-23"
}

4. Maneja los casos comunes

• 404 no_encontrado: el RUC no está en el padrón. No se cobra.
• 400 ruc_invalido: no tiene 11 dígitos o el dígito verificador no cuadra. No se cobra.
• 429: superaste un límite. Mira Límites y cuotas.

También puedes probar todo sin escribir código desde Probar la API en el panel.