SUNARP and connections: query with your own account

Peru's public registries are now on Croma: search partidas by number, plate or ficha and read every inscription as a PDF, signed in as your own account.

Cristian Correa
Product

Some sources only answer to a signed-in person. SUNARP, Peru's public registries, is one: it asks for a DNI. Starting today you can query it through Croma with your own account, registered once as a connection.

Two new endpoints#

  • Registry search (/pe/sunarp/registry-search/v1): an office (for example LIMA), a registry (real estate, vehicles, companies, mining, vessels, aircraft and more) and a partida, plate or ficha number.
  • Registry entry (/pe/sunarp/registry-entry/v1): a partida's inscriptions with their act, date and title, and every page as a PDF, kept by Croma.

How it works#

How connections work A top down flow: register your account once, Croma checks and encrypts it, you query as usual, and Croma queries as your account. Register your account once Croma checks and encrypts it Query as usual Croma queries as your account

Register the connection once:

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

Then query with nothing 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"}'

Automatic rotation#

SUNARP allows five sign-ins a day per DNI. Croma keeps the session open between queries, and if you register more than one connection, it rotates between them:

Rotation across connections A top down flow: Croma picks one of your connections and checks whether it has allowance left today. If yes, it queries as that account and answers. If not, the connection is paused until the reset and Croma moves to your next connection, back to the top. Pick one of your connections Allowance left today Yes: query as that account No: paused until the reset Answer Move to your next connection

Each account handles one query at a time, so it never signs in twice in parallel; different accounts do work at the same time. Answers are kept for 30 days: a repeated question does not go back to the source.

Your credentials#

  • They are encrypted as soon as they arrive and bound to your organization.
  • Only the isolated service that signs in to the source can open them.
  • The API never returns them; you only see a masked name.
  • Deleting a connection destroys it permanently.

From an agent too#

The MCP server has sunarp_connect, sunarp_list_connections and sunarp_delete_connection: an agent can connect your account in conversation, with your consent, and then query.

The full flow, with diagrams, is in Connections, and each endpoint's fields in the SUNARP guide.

Build on government data

The official records of the United States, Brazil, Mexico, Peru and Colombia in one typed API, ready for your agents.

Get API access nowBook a demo