Consultar un RUC

GET /v1/ruc/{ruc} devuelve los datos de un contribuyente del padrón de SUNAT.

GET /v1/ruc/{ruc}

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

Respuesta 200

{
  "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"
}

Campo	Tipo	Descripción
`ruc`	string	11 dígitos.
`razonSocial`	string	Nombre o razón social tal como figura en SUNAT.
`estado`	string \| null	ACTIVO, BAJA DE OFICIO, BAJA DEFINITIVA, SUSPENSION TEMPORAL…
`condicion`	string \| null	Condición del domicilio fiscal: HABIDO, NO HABIDO, NO HALLADO…
`direccion`	string \| null	Domicilio fiscal armado como lo escribe SUNAT (vía, número, interior, zona).
`ubigeo`	string \| null	Código INEI de 6 dígitos.
`departamento`, `provincia`, `distrito`	string \| null	El ubigeo traducido.
`tipo`	string	`persona_juridica` (RUC 20), `persona_natural` (RUC 10, 15, 17) u `otro`.
`fechaPadron`	string \| null	Fecha (AAAA-MM-DD) del archivo de SUNAT con que se respondió.

Validación del RUC

Antes de buscar, comprobamos que tenga 11 dígitos, empiece con 10, 15, 16, 17 o 20 y que el dígito verificador (módulo 11) sea correcto. Si no, respondemos 400 ruc_invalido sin cobrar. Puedes hacer la misma validación en tu formulario para no gastar ni una petición.