Skip to content

Dossier Creation

POST dossiers

Creates a new dossier. The dossier can then be shared using the Dossier Sharing endpoint.

Example Request#

curl -X POST 'https://api.pricehubble.com/api/v1/dossiers?access_token=74126eab0a9048d993bda4b1b55ae074' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "My dossier",
  "description": "My description",
  "dealType": "sale",
  "property": {
    "location": {
      "address": {
        "postCode": "8037",
        "city": "Zurich",
        "street": "Nordstrasse",
        "houseNumber": "391"
      },
      "coordinates": {
        "latitude": 47.3968601,
        "longitude": 8.5153549
      }
    },
    "propertyType": {
      "code": "house",
      "subcode": "house_detached"
    },
    "buildingYear": 1990,
    "livingArea": 100.00,
    "landArea": 900.00,
    "volume": 900.00,
    "numberOfRooms": 3,
    "numberOfBathrooms": 1,
    "numberOfIndoorParkingSpaces": 0,
    "numberOfOutdoorParkingSpaces": 0,
    "hasPool": true,
    "condition": {
      "bathrooms": "renovation_needed",
      "kitchen": "renovation_needed",
      "flooring": "well_maintained",
      "windows": "new_or_recently_renovated"
    },
    "quality": {
      "bathrooms": "simple",
      "kitchen": "normal",
      "flooring": "high_quality",
      "windows": "luxury"
    }
  },
  "userDefinedFields": [
    {
      "label": "Extra garage",
      "value": "Yes"
    }
  ],
  "images": [
    {
      "filename": "633390e8-0455-4520-87ba-3c5c8c234cb3.jpg",
      "caption": "Front view"
    }
  ],
  "logo": "b7219677-f4d5-4e99-9d7f-7cf1dee68900.png",
  "countryCode": "CH"
}'

Request fields#

Field Description Type Remarks
title Dossier title string
description Dossier description string Maximum of 2000 characters
dealType Deal type of the dossier enum sale or rent (not needed for multi_family_house property type code)
property Information about the property Property
property.propertyType.code Property type PropertyType JP: house is only supported if dealType is sale
property.location.coordinates Coordinates of the property Coordinates If property.location.coordinates is not provided, property.location.address is used to perform a geocoding lookup.
property.location.address Address of the property Address postCode and city are mandatory fields of the address. The address provided will be shown in the shared dossier.
askingSalePrice Asking price in the main currency of the dossier’s country. The asking price will show up in dossier permalinks (see Dossier Sharing). integer Only relevant if dealType is sale
valuationOverrideSalePrice Custom sale price valuation that overrides PriceHubble's valuation integer Only relevant if dealType is sale
valuationOverrideSalePriceRange Custom sale price valuation range that overrides PriceHubble's valuation LowerUpperBound Only relevant if dealType is sale
valuationOverrideRentNet Custom net rent valuation that overrides PriceHubble's valuation integer Only relevant if dealType is rent
valuationOverrideRentNetRange Custom net rent valuation range that overrides PriceHubble's valuation LowerUpperBound Only relevant if dealType is rent
valuationOverrideRentGross Custom gross rent valuation that overrides PriceHubble's valuation integer Only relevant if dealType is rent
valuationOverrideRentGrossRange Custom gross rent valuation range that overrides PriceHubble's valuation LowerUpperBound Only relevant if dealType is rent
userDefinedFields User Defined Fields array of User Defined Fields max items: 12
images Dossier images array of Dossier Images max items: 20
logo Dossier logo filename string Get the filename from Dossier Logos endpoint
countryCode ISO country code string

Example Response#

{
    "id": "119a6ead-4ac4-4b4b-b264-195a2895618e"
}

Response fields#

Field Description Type Remarks
id ID of the newly created dossier string