Skip to main content
placeanalyzerAPI ReferenceGuías

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 propertyTypem2Landm2Builtm2Coveredm2SemiCoveredpropertyAgepropertyCondition
TerrenoRequiredNot requiredNot requiredNot requiredNot requiredNot required
DepartamentoNot requiredNot requiredRequiredRequiredRequiredNot required
Other (Casa, Duplex, Deposito, Tinglado, Oficina, Local Comercial, Propiedad rural, Casa quinta, Edificio)RequiredRequiredNot requiredNot requiredRequiredRequired

Note: Fields marked as

Not required may be omitted from the JSON or sent as null.

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"

createValuationRequestPublic

POST 

/valuation-request

createValuationRequestPublic

Request​

Responses​

OK


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.

getValuationPublic

GET 

/valuation-request/:requestCode

getValuationPublic

Request​

Responses​

OK

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.

getValuationResult

GET 

/valuation-request/:requestCode/result

getValuationResult

Request​

Responses​

OK

API Reference

Create appraisal

POST

Get appraisal

GET

Get appraisal result

GET