Endpoint: empresa Perú en SUNARP (razón social o siglas)

Busca personas jurídicas inscritas en el índice nacional de SUNARP por razón social o por siglas, con mínimo 3 caracteres, y devuelve cada coincidencia con su número de partida, razón social, siglas y oficina registral. Es el directorio, no la ficha registral: no trae RUC, representantes, capital ni domicilio. Para el estado tributario de la empresa por RUC está /api/company-pe. Un término imposible responde 400 sin cobrar; un criterio sin coincidencias es una respuesta válida y cobra.

POST/api/empresa-pe1 crédito

Busca personas jurídicas inscritas en el índice nacional de SUNARP por razón social o por siglas. Devuelve, por cada coincidencia, el número de partida, la razón social, las siglas y la oficina registral. La búsqueda exige al menos 3 caracteres en el campo que se use; un término imposible responde 400 sin cobrar. ⚠️ Es el índice/directorio, no la ficha registral: no entrega RUC, representantes, capital ni domicilio —eso exige consultar la partida en el SPRL—. Un criterio sin coincidencias es una respuesta válida (el directorio no la tiene) y cobra. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "razonSocial": "BANCO INTERNACIONAL DEL PERU"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
razonSocial	string	Razón o denominación social, mínimo 3 caracteres. Se compara en mayúsculas. Alias aceptados: `razon`, `nombre`, `empresa`.
siglas	string	Siglas de la empresa, mínimo 3 caracteres (ej. `INTERBANK`). Alias aceptado: `sigla`. Se puede mandar sola o junto con la razón social.
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/empresa-pe' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"razonSocial":"BANCO INTERNACIONAL DEL PERU"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/empresa-pe", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"razonSocial":"BANCO INTERNACIONAL DEL PERU"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/empresa-pe",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"razonSocial":"BANCO INTERNACIONAL DEL PERU"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "source": "empresaPe",
  "status": "ok",
  "data": {
    "consulta": {
      "razonSocial": null,
      "siglas": "INTERBANK"
    },
    "total": 1,
    "resultados": [
      {
        "numPartida": "11005055",
        "razonSocial": "BANCO INTERNACIONAL DEL PERU",
        "siglas": "INTERBANK",
        "oficina": "ICA"
      }
    ]
  },
  "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.