Search
K
[dev] 🇩🇪 Listings Management Germany

distributionType

string

the distribution type of the property.

  • BUY: regular type of property for sale
    de: Kauf
  • RENT: regular type of property for rent
    de: Miete
  • COMPULSORY_AUCTION: auction ordered by the courts
    de: Zwangsversteigerung
  • BUY_AUCTION: bids for the property can be submitted within a
    limited time period. The seller can accept, reject or negotiate
    the bid. Most important difference to a classic auction: the
    highest bid does not necessarily have to win.
    de: Bieterverfahren

Allowed values:BUYRENTCOMPULSORY_AUCTIONBUY_AUCTION

>= 1 characters

Example

location

object

geographical information of the real estate property

* Additional properties are NOT allowed.
postalcodestringrequired

postalcode or zip of the property location.

Match pattern:^[a-zA-Z0-9\s-]{3,12}$

>= 3 characters<= 12 characters

Example:22455

citystringrequired

city where the property is located.

>= 1 characters<= 128 characters

Example:Hamburg

streetstringrequired

street where the property is located. It can also be a place name or any required neighbourhood information.

>= 1 characters<= 512 characters

Example:Hauptstrasse

houseNumberstringrequired

house number where the property is located.

>= 1 characters<= 64 characters

Example:10

unitstring

An apartment, unit, office, lot, or other secondary unit designator

>= 1 characters<= 64 characters

Example:Block C

staircasestring

numbered/lettered staircase

>= 1 characters<= 64 characters

Example:A

floorNumberinteger

number of the floor in the building; 0 means ground floor, NOT first floor; 1 means first upper floor; -1 means first basement floor

>= -5<= 999

Example:2

entrancestring

numbered/lettered entrance

>= 1 characters<= 32 characters

Example:123

statestring

state within the country where the property is located

>= 1 characters<= 128 characters

Example:Bavaria

countrystringrequired

country where the property is located, using the ISO 3166-1 alpha-3 country code standard.

Allowed values:ABWAFGAGOAIAALAALBANDAREARGARMASMATAATFATGAUSAUTAZEBDIBELBENBESBFABGDBGRBHRBHSBIHBLMBLRBLZBMUBOLBRABRBBRNBTNBVTBWACAFCANCCKCHECHLCHNCIVCMRCODCOGCOKCOLCOMCPVCRICUBCUWCXRCYMCYPCZEDEUDJIDMADNKDOMDZAECUEGYERIESHESPESTETHFINFJIFLKFRAFROFSMGABGBRGEOGGYGHAGIBGINGLPGMBGNBGNQGRCGRDGRLGTMGUFGUMGUYHKGHMDHNDHRVHTIHUNIDNIMNINDIOTIRLIRNIRQISLISRITAJAMJEYJORJPNKAZKENKGZKHMKIRKNAKORKWTLAOLBNLBRLBYLCALIELKALSOLTULUXLVAMACMAFMARMCOMDAMDGMDVMEXMHLMKDMLIMLTMMRMNEMNGMNPMOZMRTMSRMTQMUSMWIMYSMYTNAMNCLNERNFKNGANICNIUNLDNORNPLNRUNZLOMNPAKPANPCNPERPHLPLWPNGPOLPRIPRKPRTPRYPSEPYFQATREUROURUSRWASAUSDNSENSGPSGSSHNSJMSLBSLESLVSMRSOMSPMSRBSSDSTPSURSVKSVNSWESWZSXMSYCSYRTCATCDTGOTHATJKTKLTKMTLSTONTTOTUNTURTUVTWNTZAUGAUKRUMIURYUSAUZBVATVCTVENVGBVIRVNMVUTWLFWSMYEMZAFZMBZWE

>= 3 characters<= 3 characters

Example:DEU

geometryobjectrequired

Coordinates of the property using GeoJSON Point format. WGS84 (GPS) System expected. The coordinates array must contain [longitude, latitude] in that order.

* Additional properties are NOT allowed.
Show Child Parameters
showAddressboolean

may the complete address be visible to everyone who sees the property online? if false, street and houseNumber may not be displayed in any case!

Default:true

Example:true

locationNoteobject

additional information about the area where the property is located

Example:{"de":"Hallo!","en":"Hello!","fr":"Bonjour!","nl":"Hallo!"}

* Additional properties are NOT allowed.
countrySpecificobject
* Additional properties are NOT allowed.
Show Child Parameters
Example

prices

object

contains different prices and price types for a property

* Additional properties are NOT allowed.
currencystring

the currency of all prices defined below. the currency must be entered as ISO 4217 currency code. Please refer to https://www.iso.org/iso-4217-currency-codes.html Last checked: October 1st, 2021 Here are the alphabetic three-letter country codes: - AED: UAE Dirham - AFN: Afghani - ALL: Lek - AMD: Armenian Dram - ANG: Netherlands Antillean Guilder - AOA: Kwanza - ARS: Argentine Peso - AUD: Australian Dollar - AWG: Aruban Florin - AZN: Azerbaijan Manat - BAM: Convertible Mark - BBD: Barbados Dollar - BDT: Taka - BGN: Bulgarian Lev - BHD: Bahraini Dinar - BIF: Burundi Franc - BMD: Bermudian Dollar - BND: Brunei Dollar - BOB: Boliviano - BOV: Mvdol - BRL: Brazilian Real - BSD: Bahamian Dollar - BTN: Ngultrum - BWP: Pula - BYN: Belarusian Ruble - BZD: Belize Dollar - CAD: Canadian Dollar - CDF: Congolese Franc - CHE: WIR Euro - CHF: Swiss Franc - CHW: WIR Franc - CLF: Unidad de Fomento - CLP: Chilean Peso - CNY: Yuan Renminbi - COP: Colombian Peso - COU: Unidad de Valor Real - CRC: Costa Rican Colon - CUC: Peso Convertible - CUP: Cuban Peso - CVE: Cabo Verde Escudo - CZK: Czech Koruna - DJF: Djibouti Franc - DKK: Danish Krone - DOP: Dominican Peso - DZD: Algerian Dinar - EGP: Egyptian Pound - ERN: Nakfa - ETB: Ethiopian Birr - EUR: Euro - FJD: Fiji Dollar - FKP: Falkland Islands Pound - GBP: Pound Sterling - GEL: Lari - GHS: Ghana Cedi - GIP: Gibraltar Pound - GMD: Dalasi - GNF: Guinean Franc - GTQ: Quetzal - GYD: Guyana Dollar - HKD: Hong Kong Dollar - HNL: Lempira - HRK: Kuna - HTG: Gourde - HUF: Forint - IDR: Rupiah - ILS: New Israeli Sheqel - INR: Indian Rupee - IQD: Iraqi Dinar - IRR: Iranian Rial - ISK: Iceland Krona - JMD: Jamaican Dollar - JOD: Jordanian Dinar - JPY: Yen - KES: Kenyan Shilling - KGS: Som - KHR: Riel - KMF: Comorian Franc - KPW: North Korean Won - KRW: Won - KWD: Kuwaiti Dinar - KYD: Cayman Islands Dollar - KZT: Tenge - LAK: Lao Kip - LBP: Lebanese Pound - LKR: Sri Lanka Rupee - LRD: Liberian Dollar - LSL: Loti - LYD: Libyan Dinar - MAD: Moroccan Dirham - MDL: Moldovan Leu - MGA: Malagasy Ariary - MKD: Denar - MMK: Kyat - MNT: Tugrik - MOP: Pataca - MRU: Ouguiya - MUR: Mauritius Rupee - MVR: Rufiyaa - MWK: Malawi Kwacha - MXN: Mexican Peso - MXV: Mexican Unidad de Inversion (UDI) - MYR: Malaysian Ringgit - MZN: Mozambique Metical - NAD: Namibia Dollar - NGN: Naira - NIO: Cordoba Oro - NOK: Norwegian Krone - NPR: Nepalese Rupee - NZD: New Zealand Dollar - OMR: Rial Omani - PAB: Balboa - PEN: Sol - PGK: Kina - PHP: Philippine Peso - PKR: Pakistan Rupee - PLN: Zloty - PYG: Guarani - QAR: Qatari Rial - RON: Romanian Leu - RSD: Serbian Dinar - RUB: Russian Ruble - RWF: Rwanda Franc - SAR: Saudi Riyal - SBD: Solomon Islands Dollar - SCR: Seychelles Rupee - SDG: Sudanese Pound - SEK: Swedish Krona - SGD: Singapore Dollar - SHP: Saint Helena Pound - SLL: Leone - SOS: Somali Shilling - SRD: Surinam Dollar - SSP: South Sudanese Pound - STN: Dobra - SVC: El Salvador Colon - SYP: Syrian Pound - SZL: Lilangeni - THB: Baht - TJS: Somoni - TMT: Turkmenistan New Manat - TND: Tunisian Dinar - TOP: Pa’anga - TRY: Turkish Lira - TTD: Trinidad and Tobago Dollar - TWD: New Taiwan Dollar - TZS: Tanzanian Shilling - UAH: Hryvnia - UGX: Uganda Shilling - USD: US Dollar - USN: US Dollar (Next day) - UYI: Uruguay Peso en Unidades Indexadas (UI) - UYU: Peso Uruguayo - UYW: Unidad Previsional - UZS: Uzbekistan Sum - VED: Bolívar Soberano - VES: Bolívar Soberano - VND: Dong - VUV: Vatu - WST: Tala - XAF: CFA Franc BEAC - XAG: Silver - XAU: Gold - XBA: Bond Markets Unit European Composite Unit (EURCO) - XBB: Bond Markets Unit European Monetary Unit (E.M.U.-6) - XBC: Bond Markets Unit European Unit of Account 9 (E.U.A.-9) - XBD: Bond Markets Unit European Unit of Account 17 (E.U.A.-17) - XCD: East Caribbean Dollar - XDR: SDR (Special Drawing Right) - XOF: CFA Franc BCEAO - XPD: Palladium - XPF: CFP Franc - XPT: Platinum - XSU: Sucre - XTS: Codes specifically reserved for testing purposes - XUA: ADB Unit of Account - XXX: The codes assigned for transactions where no currency is involved - YER: Yemeni Rial - ZAR: Rand - ZMW: Zambian Kwacha - ZWL: Zimbabwe Dollar

Allowed values:AEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBOVBRLBSDBTNBWPBYNBZDCADCDFCHECHFCHWCLFCLPCNYCOPCOUCRCCUCCUPCVECZKDJFDKKDOPDZDEGPERNETBEURFJDFKPGBPGELGHSGIPGMDGNFGTQGYDHKDHNLHRKHTGHUFIDRILSINRIQDIRRISKJMDJODJPYKESKGSKHRKMFKPWKRWKWDKYDKZTLAKLBPLKRLRDLSLLYDMADMDLMGAMKDMMKMNTMOPMRUMURMVRMWKMXNMXVMYRMZNNADNGNNIONOKNPRNZDOMRPABPENPGKPHPPKRPLNPYGQARRONRSDRUBRWFSARSBDSCRSDGSEKSGDSHPSLLSOSSRDSSPSTNSVCSYPSZLTHBTJSTMTTNDTOPTRYTTDTWDTZSUAHUGXUSDUSNUYIUYUUYWUZSVEDVESVNDVUVWSTXAFXAGXAUXBAXBBXBCXBDXCDXDRXOFXPDXPFXPTXSUXTSXUAXXXYERZARZMWZWL

Default:EUR

Example:EUR

buyobject
* Additional properties are NOT allowed.
Show Child Parameters
rentobject

rent price information

* Additional properties are NOT allowed.
Show Child Parameters
compulsoryAuctionobject

compulsory/foreclosure auction price information.

* Additional properties are NOT allowed.
Show Child Parameters
buyAuctionobject

Bid process. The purchase is voluntarily. The minimum price is set by the offerer. Potential buyers make an offer within a particular period. The offerer decides, if he accepts the highest bid, it is not binding as in a typical auction.

* Additional properties are NOT allowed.
Show Child Parameters
brokerageFeeobject

Real estate agency or broker Fee detailed information commission for the real estate agent; de: Maklerprovision fr: Frais d’agence

* Additional properties are NOT allowed.
showPriceboolean

general setting for displaying the price on the portal/ website

Example:true

priceNoteobject

textarea for further price information, taxes or fees.

Example:{"de":"Hallo!","en":"Hello!","fr":"Bonjour!","nl":"Hallo!"}

* Additional properties are NOT allowed.
Show Child Parameters
countrySpecificobject
* Additional properties are NOT allowed.
Show Child Parameters
Example

spaces

object

contains different space types for a property. you can submit multiple spaces here (e.g. livingSpace, atticSpace and gardenSpace)

* Additional properties are NOT allowed.
spaceMeasureUnitstringrequired

measure unit for the space (square meter by default).

Allowed values:SQUARE_METERSQUARE_INCHSQUARE_FOOTSQUARE_YARDHECTAREACRE

Default:SQUARE_METER

buildingFrontnumber

building front facade in length measure unit (meter, inch, foot, yard, …) Based on spaces.spaceMeasureUnit, so meters will be used as default if empty.

>= 0<= 99999999

Example:23

kitchenSpacenumber

space of the kitchen

>= 0<= 99999999

overallSpacenumber

total space of the property

>= 0<= 99999999

usableFloorSpacenumber

space that can be used, after deducting functional areas, stairs, etc. depending on the purpose

>= 0<= 99999999

spaceMaxnumber

For a catalog house or a new built house or a program, the biggest property available, built or not yet built. If a property has different units/ spaces, this is the biggest space it has

>= 0<= 99999999

spaceMinnumber

For a catalog house or a new built house or a program, the smallest property available, built or not yet built. If a property has different units/ spaces, this is the smallest space it has

>= 0<= 99999999

plotSpacenumber

space of the plot

>= 0<= 99999999

plotFrontnumber

plot front in length measure unit (meter, inch, foot, yard, …) Based on spaces.spaceMeasureUnit, so meters will be used as default if empty.

>= 0<= 99999999

Example:60

additionalSpacenumber

contains all cumulated additional space from outbuilding, extended or misc places.

>= 0<= 99999999

residentialobject

residential / living space types with their value.

* Additional properties are NOT allowed.
Show Child Parameters
commercialobject

commercial space types with their value.

* Additional properties are NOT allowed.
Show Child Parameters
Example

conditions

object

Condition information of the property.

* Additional properties are NOT allowed.
buildStatestring

What is the current condition of the property? - FIRST_TIME_USE: never been inhabited before - FIRST_TIME_USE_AFTER_REFURBISHMENT: never been inhabited since
last refurbishment

  • MINT_CONDITION: perfect shape - MODERNISED: property architecture has been modernised - REFURBISHED: property is now as new - FULLY_RENOVATED: All the property is renovated - PARTLY_RENOVATED: some parts of the property have been renovated - NEED_OF_RENOVATION: the property needs to be renovated? - WELL_KEPT: good shape. - NEGOTIABLE: the property is not very well kept but it can be used - RIPE_FOR_DEMOLITION: Property to be demolished - PROJECTED: Not yet built. A project state. - NO_INFORMATION: Same as if you don’t provide any data in this field. - RESTRUCTURED: redesigned, overhauled - TO_RESTORE: property needs restoration. - TO_REFURBISH: property needs refurbishment.

Allowed values:FIRST_TIME_USEFIRST_TIME_USE_AFTER_REFURBISHMENTMINT_CONDITIONMODERNISEDREFURBISHEDFULLY_RENOVATEDPARTLY_RENOVATEDNEED_OF_RENOVATIONWELL_KEPTNEGOTIABLERIPE_FOR_DEMOLITIONPROJECTEDNO_INFORMATIONRESTRUCTUREDTO_RESTORETO_REFURBISH

ageStatestring

the age of the building: OLD is defined as built before 1945. NEW is defined as built within the last 5 years.

Allowed values:OLDNEW

lastModernisationinteger

last year of modernisation

Example:2010

constructionStylestring

General construction style of tbe building

Allowed values:PREFABRICATEDSOLIDSOLID_PREFABRICATEDTIMBERHOUSEWOOD_PREFABRICATEDUNSPECIFIED

yearOfConstructioninteger

year of construction

>= 1000<= 3000

Example:2000

Example