SUNARP y conexiones: consulta con tu propia cuenta

Hay fuentes que solo responden a una persona con sesión iniciada. SUNARP, los Registros Públicos del Perú, es una: pide un DNI. Desde hoy puedes consultarla en Croma con tu propia cuenta, registrada una sola vez como conexión.

Dos endpoints nuevos#

Búsqueda de partidas (/pe/sunarp/registry-search/v1): una oficina (por ejemplo LIMA), un registro (predios, vehículos, personas jurídicas, minería, naves, aeronaves y más) y un número de partida, placa o ficha.
Partida registral (/pe/sunarp/registry-entry/v1): los asientos de una partida con su acto, fecha y título, y cada página en PDF, guardada por Croma.

Cómo funciona#

Registras la conexión una vez:

curl https://api.croma.run/pe/sunarp/connections/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document_number": "12345678", "check_digit": "1", "issue_date": "2020-01-01", "authorized": true}'

Y desde ahí consultas sin nada extra:

curl https://api.croma.run/pe/sunarp/registry-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"office": "LIMA", "registry_area": "vehicles", "search_by": "plate", "number": "ABC123"}'

Rotación automática#

SUNARP permite cinco inicios de sesión al día por DNI. Croma mantiene la sesión abierta entre consultas, y si registras más de una conexión, rota entre ellas:

Cada cuenta atiende una consulta a la vez, así que nunca inicia sesión dos veces en paralelo; cuentas distintas sí trabajan al mismo tiempo. Las respuestas se guardan 30 días: una pregunta repetida no vuelve a la fuente.

Tus credenciales#

Se cifran en cuanto llegan y quedan ligadas a tu organización.
Solo el servicio aislado que inicia sesión en la fuente puede abrirlas.
La API nunca las devuelve; ves solo un nombre enmascarado.
Eliminar una conexión la destruye de forma permanente.

También desde un agente#

En el servidor MCP están sunarp_connect, sunarp_list_connections y sunarp_delete_connection: un agente puede conectar tu cuenta en la conversación, con tu consentimiento, y luego consultar.

El flujo completo, con diagramas, está en Conexiones, y los campos de cada endpoint en la guía de SUNARP.