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

**Publicado:** 1 de outubro de 2026 | **Autores:** Cristian Correa

---

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

```mermaid
flowchart TD
  A["Registre sua conta uma vez"] --> B["A Croma verifica e criptografa"]
  B --> C["Consulte como sempre"]
  C --> D["A Croma consulta com sua conta"]
```

Registre a conexão uma vez:

```bash
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:

```bash
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:

```mermaid
flowchart TD
  A["Escolhe uma das suas conexões"] --> B{"Tem cota hoje"}
  B --> C["Com cota: consulta com essa conta"]
  B --> D["Sem cota: pausada até o reinício"]
  C --> E["Resposta"]
  D --> F["Passa para a sua próxima conexão"]
  F --> A
```

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](https://docs.usecroma.com/pt/connections), e os campos de cada endpoint no [guia da SUNARP](https://docs.usecroma.com/pt/guides/peru/sunarp).

---

**Mais novidades:** [Ver todas as entradas do changelog](/pt/changelog/sitemap.md) | [Croma](https://usecroma.com)