Skip to main content
POST
SUNARP Registry Search

Authorizations

Authorization
string
header
required

Use Authorization: Bearer YOUR_API_KEY

Headers

Idempotency-Key
string

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Maximum string length: 255
Example:

"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"

Prefer
string

Set wait=N to hold the connection up to N seconds for an inline result. If the job finishes in time you get the normal 200 body; otherwise a 202 with a status_url to poll.

Example:

"wait=30"

Body

application/json
office
string
required

The registry office (oficina registral) by name, e.g. LIMA, AREQUIPA, CUSCO. Case and accents are ignored.

Required string length: 2 - 60
registry_area
enum<string>
required

The registry: real_estate (propiedad inmueble predial), non_land_property (propiedad inmueble no predial), legal_entities (personas jurídicas), natural_persons (personas naturales), vehicles (propiedad vehicular), mining (propiedad minera), vessels (naves y embarcaciones), aircraft (aeronaves) or movable_contracts (registro mobiliario de contratos).

Available options:
real_estate,
non_land_property,
legal_entities,
natural_persons,
vehicles,
mining,
vessels,
aircraft,
movable_contracts
number
string
required

The partida, plate or ficha number, e.g. 53237569 or AKI774. Spaces and hyphens are ignored.

Required string length: 3 - 12
Pattern: ^[A-Za-z0-9][A-Za-z0-9 -]{1,10}[A-Za-z0-9]$
search_by
enum<string>
default:partida

What number is: partida (the registry entry number, the default), plate (vehicles only) or ficha (the older card number, every registry except vehicles). A partida starting with P is written as P12345678.

Available options:
partida,
plate,
ficha
connection_id
string
default:""

Optional. Run as this connection (conn_…). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance.

callback_url
string<uri>

POST the job result here when it finishes.

Response

Successful response

data
object
required