Owned properties

View as Markdown
Real estate registered to your customer in the official Spanish records. One entry per property owned or co-owned: location, cadastral identification, value and the ownership share. Asset verification and solvency analysis from the register rather than from a declaration. Field by field in [Properties](/guides/data-models/properties). <Note title="Requires the `properties_data` feature"> Features are chosen when the execution **starts**, not here. An execution that did not ask for `properties_data` answers `204`, and the only way to get the data is to run another one. </Note> | Status | Meaning | | :--- | :--- | | `200` | The properties. | | `202` | `feature_not_ready` — `properties_data` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `properties_data`. No body. | | `404` | No execution with that id for your application, or it has been deleted. | <Note> **Server to server only.** This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read. </Note>

Authentication

X-APP-SECRETstring
Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"
The execution, as the acceptance response returned it.

Response

200 OK
Real estate registered to your customer in Spain, with its cadastral reference, use, surface, share of ownership and the value the cadastre assigns it.

An empty list is an answer, not a gap: the feature ran and the source reported none.

product"owned_property"
sub_family"owned_property:es_owned_property"
fetch_datestringformat: "datetime"
Date this product was fetched
countrystringformat: "country"
Country of the property.
ownerslist of objects
List of owners of the property.
cadastral_referencestringOptional
Unique cadastral reference identifier.
addressstringOptional
Full address of the property.
property_typestringOptional

Type of property (e.g., Urban, Rustic).

property_usestringOptional

Main use of the property (e.g., Residential).

assessment_yearstringOptional
Year of the catastral assessment.
assessed_valuemap from strings to stringsOptional
Total assessed cadastral value.
land_valuemap from strings to stringsOptional
Assessed land value.
construction_valuemap from strings to stringsOptional
Assessed construction value.
download_infoobjectOptional
Internal metadata for downloading documents.

Errors

404
Not Found Error
422
Unprocessable Entity Error