Individual Appraisals
The Appraisals API allows you to manage the complete lifecycle of an individual property valuation request. Through these endpoints, you can register new requests for a property and subsequently check its status and results.
Create appraisal request
Register a new appraisal request for a property. The property information must be provided in the request body.
Request fields
1. Globally required fields
These fields must be present in every request, regardless of property type:
latitude(number, double): GPS latitude in decimal degrees. Must be between -90 and 90.longitude(number, double): GPS longitude in decimal degrees. Must be between -180 and 180.property(object): Property details.property.propertyType(string): Property type. Allowed values:Terreno,Casa,Duplex,Departamento,Deposito,Tinglado,Oficina,Local Comercial,Propiedad rural,Casa quinta,Edificio.
2. Conditional required fields
Depending on propertyType, the following fields inside property become required: m2Land, m2Built, m2Covered, m2SemiCovered, propertyAge, and propertyCondition.
Property type propertyType | m2Land | m2Built | m2Covered | m2SemiCovered | propertyAge | propertyCondition |
|---|---|---|---|---|---|---|
| Terreno | Required | Not required | Not required | Not required | Not required | Not required |
| Departamento | Not required | Not required | Required | Required | Required | Not required |
Other (Casa, Duplex, Deposito, Tinglado, Oficina, Local Comercial, Propiedad rural, Casa quinta, Edificio) | Required | Required | Not required | Not required | Required | Required |
Note: Fields marked as
Not required may be omitted from the JSON or sent asnull.
Example for Departamento:
{ "latitude": -25.2821, "longitude": -57.6353, "property": { "propertyType": "Departamento", "m2Covered": 80, "m2SemiCovered": 10, "propertyAge": "Semi nuevo" } }
Validation messages (when a required field is missing):
- Terreno:
"El área del terreno (m2Land) es requerida para Terrenos" - Departamento:
"El área cubierta (m2Covered) es requerida para Departamentos""El área semicubierta (m2SemiCovered) es requerida para Departamentos""La antigüedad (propertyAge) es requerida para Departamentos"
- Other types:
"El área del terreno (m2Land) es requerida""El área construida (m2Built) es requerida""La antigüedad (propertyAge) es requerida""El estado de conservación (propertyCondition) es requerido"
Get appraisal by code
Retrieve the complete details of a specific appraisal request using the requestCode obtained during creation.
This endpoint allows you to monitor the process status and obtain the appraisal results once they are available.
Get appraisal result by code
To obtain the result of an appraisal, use the requestCode provided when creating the request. This endpoint will allow you to check the current status of the appraisal and obtain the results once they are available.