API de RUC Perú: estado, condición y dirección fiscal de una empresa desde el padrón de SUNAT

Qué problema resuelve

Antes de facturarle, pagarle o darle crédito a una empresa peruana hay que saber si su RUC está activo y si su domicilio fiscal está habido: una empresa NO HABIDA o dada de baja es una contraparte con la que una factura o un pago se complican. Esa verificación se repite en cada alta de proveedor, de cliente o de comercio, y hacerla a mano desde un navegador no escala ni deja registro. Este endpoint la convierte en una llamada REST que responde en menos de un segundo y se puede correr en el formulario de alta o sobre toda la base de proveedores.

Para quién sirve

Plataformas de facturación y ERPs con clientes en Perú, fintech y empresas de factoring que evalúan a la contraparte, marketplaces y pasarelas de pago que dan de alta comercios, áreas de compras que validan proveedores, y equipos de cumplimiento que ya hacen debida diligencia de empresas colombianas con PlacApi y necesitan cubrir Perú.

Datos requeridos

• ruc — RUC de empresa: 11 dígitos que empiezan por 20. Alias aceptados: documentNumber, documento y numeroDocumento.
• refresh — opcional: salta la caché de 7 días.

Fuentes y cobertura

• SUNAT — padrón de contribuyentesEl padrón oficial de contribuyentes de la Superintendencia Nacional de Aduanas y de Administración Tributaria: RUC, razón social, estado del contribuyente, condición de domicilio, ubigeo y dirección fiscal desagregada (tipo y nombre de vía, número, interior, lote, manzana, kilómetro, zona). PlacApi lo sincroniza cada semana.
• SUNARP — índice de personas jurídicasEl índice nacional de personas jurídicas inscritas en la Superintendencia Nacional de los Registros Públicos: número de partida, razón social, siglas y oficina registral. Lo usa /api/empresa-pe para buscar por nombre.

¿Qué API consulta el RUC de una empresa peruana en SUNAT?

PlacApi publica dos endpoints de empresas peruanas que se complementan. /api/company-pe responde por RUC desde el padrón de SUNAT: si la empresa está activa, si su domicilio está habido y cuál es su dirección fiscal. /api/empresa-pe responde por nombre desde la SUNARP: dada una razón social o unas siglas, qué personas jurídicas están inscritas, con qué número de partida y en qué oficina registral. Cada uno cobra su crédito y los dos usan la misma API key.

El flujo habitual es el primero solo: el usuario escribe el RUC en el alta y el backend confirma razón social, estado y condición antes de guardar. El segundo sirve cuando lo que se tiene es el nombre, o para confirmar que la empresa existe como persona jurídica inscrita y no solo como contribuyente.

Estado y condición: los dos campos que deciden si se puede operar con la empresa

estado dice si el contribuyente sigue vivo para SUNAT: ACTIVO, o alguna forma de baja (BAJA DE OFICIO, BAJA DEFINITIVA, SUSPENSION TEMPORAL…). condicion dice si SUNAT pudo ubicar a la empresa en su domicilio fiscal: HABIDO o NO HABIDO, entre otros. Son independientes: una empresa puede estar ACTIVA y NO HABIDA, y esa combinación es justo la que un área de compras necesita detectar antes de pagar.

La API entrega los dos valores tal como los escribe el padrón, sin traducirlos a un veredicto. Qué combinación se acepta es una regla de negocio: un ERP puede bloquear la factura a una empresa NO HABIDA y una plataforma de pagos puede solo marcarla para revisión.

Por qué responde en menos de un segundo, y qué tan fresco es el dato

/api/company-pe no consulta un portal en vivo: PlacApi sincroniza el padrón completo de SUNAT cada semana y responde desde esa copia. Por eso no hay captcha, no hay colas y la latencia es la de una búsqueda en base de datos, también en lotes grandes.

El costo es que un cambio de estado de los últimos días puede no estar reflejado todavía. Para un alta de proveedor o una depuración de base es irrelevante; si tu proceso exige el estado del mismo día, como una devolución de impuestos, conviene confirmarlo además por la vía oficial.

¿Cuánto cuesta la API de RUC de SUNAT?

1 crédito por consulta con datos: 349 COP en el tramo de entrada y hasta 99 COP por volumen, sin mensualidad y con créditos que no vencen. Un RUC mal formado responde 400 sin cobrar y uno que no está en el padrón responde 404 y reembolsa el crédito.

¿Es la API oficial de SUNAT?

No. PlacApi no es SUNAT: es un servicio privado que entrega en JSON lo que publica el padrón oficial de contribuyentes de SUNAT, sincronizado cada semana, con un contrato estable y la misma API key que el resto de su catálogo.

Ejemplo de solicitud

POST https://placapi.com/api/company-pe. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

curl -X POST 'https://placapi.com/api/company-pe' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"ruc":"20605980008"}'

Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/company-pe.

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

{
  "source": "sunatRucPe",
  "status": "ok",
  "data": {
    "ruc": "20605980008",
    "razonSocial": "MERCADOLIBRE PERU S.R.L.",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "ubigeo": "150131",
    "direccion": "AV. VICTOR ANDRES BELAUNDE NRO. 332 INT. 702 URB. EL ROSARIO UBIGEO 150131",
    "tipoVia": "AV.",
    "nombreVia": "VICTOR ANDRES BELAUNDE",
    "numero": "332",
    "interior": "702",
    "lote": null,
    "manzana": null,
    "kilometro": null,
    "zonaCodigo": "URB.",
    "zonaTipo": "EL ROSARIO",
    "departamento": null,
    "cobertura": {
      "razonSocial": true,
      "estado": true,
      "condicion": true,
      "ubigeo": true,
      "direccion": true,
      "representantes": false,
      "capital": false,
      "fechaConstitucion": false
    }
  },
  "mode": "live",
  "fetchedAt": "2026-11-07T15:04:05.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• Cubre personas jurídicas (RUC que empieza por 20). Un RUC 10, de persona natural con negocio, responde 400 sin cobrar.
• No entrega representantes legales, capital, fecha de constitución, actividad económica ni trabajadores: el padrón no los publica, y el bloque cobertura lo declara.
• El padrón se sincroniza cada semana: un cambio de estado o de condición de los últimos días puede no estar reflejado.
• Un RUC que no figura en el padrón responde 404 no_encontrado y no cobra.
• /api/empresa-pe es el índice de la SUNARP, no la ficha registral: no trae RUC, representantes, capital ni domicilio.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

Seguir explorando

• API de DNI Perú: nombres por DNI y carné de extranjería→
• API RUES: empresas de Colombia por NIT→
• Consulta vehicular SUNARP por placa vía API→
• Referencia del endpoint POST /api/company-pe→
• Referencia del endpoint POST /api/empresa-pe→
• Todos los endpoints de Perú→