Endpoint: empresa Perú por RUC (SUNAT)

Devuelve la ficha de una empresa peruana a partir de su RUC de 11 dígitos que empieza por 20: razón social, estado del contribuyente, condición de domicilio, ubigeo y los componentes de la dirección fiscal, tal como los publica el padrón reducido oficial de SUNAT. No depende de un portal en vivo: responde en menos de un segundo, sin captcha, y el padrón se sincroniza cada semana. Un RUC con otro prefijo o largo responde 400 sin cobrar; uno que no está en el padrón responde no_encontrado y reembolsa. No entrega representantes legales, capital ni fecha de constitución, y el bloque cobertura lo declara.

POST/api/company-pe1 crédito

Empresa peruana por RUC contra el padrón reducido oficial de SUNAT: razón social, estado del contribuyente (ACTIVO, BAJA DE OFICIO…), condición de domicilio (HABIDO, NO HABIDO…), ubigeo y los componentes de la dirección fiscal tal como los publica el padrón. Cubre las personas jurídicas —RUC de 11 dígitos que empieza por 20—; un RUC con otro prefijo o largo responde 400 sin cobrar. No depende de un portal en vivo, así que responde en menos de un segundo y sin captcha; el padrón se sincroniza cada semana. NO entrega representantes legales, capital ni fecha de constitución, y cobertura lo declara. Un RUC que no está en el padrón responde no_encontrado y reembolsa. Cuesta 1 crédito.

Para qué sirve, quién lo usa y cuánto cuesta: API de RUC Perú.

Cuerpo de la solicitud

body (JSON)

{
  "ruc": "20605980008"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
rucobligatorio	string	RUC de empresa: 11 dígitos que empiezan por 20. Alias: `documentNumber`, `documento`, `numeroDocumento`.
refresh	boolean	Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL

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

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/company-pe", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"ruc":"20605980008"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/company-pe",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"ruc":"20605980008"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "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-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 7 de noviembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.