Negotiation
POST /trattativa
Negotiation margin for the zone of the property: the current discount between asking and closing price, together with its historical series.
Example Request
curl --location 'https://appraisal.realitycs.it/trattativa' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'request_uid=a5108688-bf46-4b0a-b6b9-756396769cba'
Request Fields
| Field | Required | Default | Description | Type | Example | Notes |
|---|---|---|---|---|---|---|
request_uid | yes | Identifier of the request | string | a5108688-bf46-4b0a-b6b9-756396769cba | UUID |
JSON keys in the response:
- trattativa: Array of results.
- trattativa[].percentuale: Current negotiation margin, in percentage.
- trattativa[].storico: Historical series of the negotiation margin. Keys are periods in
<year>_<quarter>format, values are the margin of that period in percentage.
Reading the historical series
storico is an object keyed by period, not an array: iterate over its keys, sorting them lexicographically to get the series in chronological order. The most recent period matches percentuale.
Example Response
{
"trattativa":[
{
"percentuale":7.7,
"storico":{
"2017_1":11.9,
"2017_2":12.1,
"2017_3":9.5,
"2017_4":9.6,
"2018_1":10.4,
"2018_2":8.5,
"2018_3":9,
"2018_4":9.2,
"2019_1":8.5,
"2019_2":9.3,
"2019_3":10.6,
"2019_4":9.1,
"2020_1":9.1,
"2020_2":8.6,
"2020_3":8.3,
"2020_4":9.1,
"2021_1":7.7,
"2021_2":8.0,
"2021_3":7.8,
"2021_4":7.9,
"2022_1":7.3,
"2022_2":6.9,
"2022_3":8.0,
"2022_4":7.1,
"2023_1":7.9,
"2023_2":8.1,
"2023_3":7.7,
"2023_4":8.1,
"2024_1":7.5,
"2024_2":8.4,
"2024_3":7.4,
"2024_4":7.4,
"2025_1":6.7,
"2025_2":7.3,
"2025_3":7.1,
"2025_4":7.2,
"2026_1":7.7
}
}
]
}