Skip to content

Comps Ita

Thin wrapper from Appraisal service to Comps API to link comparables to specific appraisals.

Important Notes

  • These services require a specific user configuration and are an exclusive alternative to the Comps API. Contact the Sales team to activate these services.
  • The appraisal request uuid required in the following api calls must be retrieved from the response of the Insert Appraisal service after having created an appraisal.

ATTENTION:

  • the base url for the following endpoints is in the Getting Started page
  • the following endpoints are slightly different from the Comps API service endpoints

searchByAttribute

POST /perizia/<uuid>/comparabili/searchByAttribute

Performs a comparable attribute search linked to an appraisal. Refer to the following sections of the Comps API Search By Attribute documentation to create this api call:

Refer to response section to view the response output of this api call.

Example Request

curl -X POST --location 'https://sandbox-appraisal.realitycs.it/perizia/5f8d0484-4186-5fb0-a3a3-ff2ead1c5cea/comparabili/searchByAttribute' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
--data-raw '{
    "Filters": {
    ...
    ...
        }
    }

fullSearchByAttribute

POST /perizia/<uuid>/comparabili/fullSearchByAttribute

Performs a detailed comparables attribute search linked to an appraisal. Refer to the following sections of the Comps API Full Search By Attribute documentation to create this api call:

Refer to response section to view the response output of this api call.

Example Request

curl -X POST --location 'https://sandbox-appraisal.realitycs.it/perizia/5f8d0484-4186-5fb0-a3a3-ff2ead1c5cea/comparabili/fullSearchByAttribute' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
--data-raw '{
    "Filters": {
    ...
    ...
        }
    }

searchByProperty

POST /perizia/<uuid>/comparabili/searchByProperty

Performs a comparables similarity search linked to an appraisal. Refer to the following sections of the Comps API Search By Property documentation to create this api call:

Refer to response section to view the response output of this api call.

Example Request

curl -X POST --location 'https://sandbox-appraisal.realitycs.it/perizia/5f8d0484-4186-5fb0-a3a3-ff2ead1c5cea/comparabili/searchByProperty' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
--data-raw '{
    "Filters": {
    ...
    ...
        }
    }

Comparable Detail

GET /perizia/<uuid>/comparabile/dettaglio/<comparable uuid>

Returns the comparable details linked to an appraisal.

  • Retrieve the comparable uuid from comparable search api call responses such as from Search By Attribute.
  • Refer to request args section of the Comps API Comparable Detail documentation to view the request arguments for this api call.

Refer to response section to view the response output of this api call.

Example Request

curl -X GET --location 'https://sandbox-appraisal.realitycs.it/perizia/5f8d0484-4186-5fb0-a3a3-ff2ead1c5cea/comparabile/dettaglio/bce151d6-2368-4cd0-a99f-ef46eb85901e' \
--header 'Authorization: Bearer <token>'

Comparable Detail ID

GET /perizia/<uuid>/comparabile/dettaglio/id/<listing id>

Returns the comparable details linked to a listing id and an appraisal. This is an alternative to the Comparable Detail api call.

  • Retrieve the listing id from the Immobiliare.it portal
  • Refer to request args section of the Comps API Comparable Detail documentation to view the request arguments for this api call.

Refer to response section to view the response output of this api call.

Example Request

curl -X GET --location 'https://sandbox-appraisal.realitycs.it/perizia/5f8d0484-4186-5fb0-a3a3-ff2ead1c5cea/comparabile/dettaglio/id/124703627' \
--header 'Authorization: Bearer <token>'

Comparable Detail PDF

GET /perizia/<uuid>/comparabile/dettaglio/<comparable uuid>/pdfbase64

Returns the comparable details PDF linked to an appraisal.

  • Retrieve the comparable uuid from comparable search api call responses such as from Search By Attribute.

Refer to the following sections of the Comps API Comparable Detail PDF documentation to create this api call:

Refer to response section to view the response output of this api call.

Example Request

curl -X GET --location 'https://sandbox-appraisal.realitycs.it/perizia/5f8d0484-4186-5fb0-a3a3-ff2ead1c5cea/comparabile/dettaglio/bce151d6-2368-4cd0-a99f-ef46eb85901e/pdfbase64' \
--header 'Authorization: Bearer <token>'