SUNARP e conexões: consulte com a sua própria conta

Algumas fontes só respondem a uma pessoa com sessão iniciada. A SUNARP, os Registros Públicos do Peru, é uma delas: pede um DNI. A partir de hoje você pode consultá-la pela Croma com a sua própria conta, registrada uma única vez como conexão.

Dois endpoints novos#

Busca de partidas (/pe/sunarp/registry-search/v1): um cartório (por exemplo LIMA), um registro (imóveis, veículos, pessoas jurídicas, mineração, embarcações, aeronaves e mais) e um número de partida, placa ou ficha.
Partida registral (/pe/sunarp/registry-entry/v1): os asientos de uma partida com o ato, a data e o título, e cada página em PDF, guardada pela Croma.

Como funciona#

Registre a conexão uma 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}'

E daí em diante consulte sem nada a mais:

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

Rodízio automático#

A SUNARP permite cinco logins por dia por DNI. A Croma mantém a sessão aberta entre as consultas e, se você registrar mais de uma conexão, alterna entre elas:

Cada conta atende uma consulta por vez, então nunca faz login duas vezes em paralelo; contas diferentes trabalham ao mesmo tempo. As respostas ficam guardadas por 30 dias: uma pergunta repetida não volta à fonte.

Suas credenciais#

São criptografadas assim que chegam e ficam vinculadas à sua organização.
Só o serviço isolado que faz login na fonte pode abri-las.
A API nunca as devolve; você vê apenas um nome mascarado.
Excluir uma conexão a destrói permanentemente.

Também a partir de um agente#

No servidor MCP estão sunarp_connect, sunarp_list_connections e sunarp_delete_connection: um agente pode conectar a sua conta na conversa, com o seu consentimento, e depois consultar.

O fluxo completo, com diagramas, está em Conexões, e os campos de cada endpoint no guia da SUNARP.