Skip to main content
POST
Create a property valuation

Authorizations

X-Api-Key
string
header
required

API key (hr_live_... or hr_test_...). Generate from Settings › Workspace › Acceso API.

Body

application/json
latitude
number
required

Property latitude (WGS84).

Example:

40.4168

longitude
number
required

Property longitude (WGS84).

Example:

-3.7038

squareMeters
number
required

Usable floor area in m².

Example:

80

searchRadius
number

Search radius in km for comparable properties. Defaults to 5. Ignored when polygon is provided.

Example:

2

polygon
object[]

Custom polygon area (min 3 points). Takes precedence over searchRadius.

locationId
string

Idealista location ID (optional, for tier management).

bedrooms
integer
Example:

3

bathrooms
integer
Example:

2

hasParking
boolean
Example:

false

hasPool
boolean
Example:

false

hasGarden
boolean
Example:

false

hasElevator
boolean
Example:

true

floorNumber
integer
Example:

4

propertyType
enum<string>
Available options:
homes,
offices,
premises,
garages
Example:

"homes"

operation
enum<string>
Available options:
sale,
rent
Example:

"sale"

conservation
enum<string>
Available options:
new,
good,
to_renovate
Example:

"good"

name
string

Custom label for this valuation.

Example:

"Calle Mayor 12, 3º B"

locationName
string

Human-readable address for display.

Example:

"Madrid Centro"

amenities
string[]

Property amenity tags.

selectedLocations
string[]

Comparable IDs to include in the calculation.

excludedComparables
string[]

Comparable IDs to exclude from the calculation.

reportConfig
object

Initial report configuration.

Response

201 - undefined