GET Marketdata

The ressource represents market data. This method returns marketdata based on the given financing terms query parameters.

Returns a list of resources identified by the following URL. The offer resource is used to retrieve a marketdata based on the given financing terms query parameters. Right now only the average nominal interest rate (averageInterestRate) and the average effective interest rate (effectiveInterestRate) will be returned.

Important: The PAngBV (Preisangabenverordnung) requires that you need to provide the following data when displaying an offer: effective and nominal interest rates, monthly rate, remaining debt after fixed interest termination (Ablauf der Sollzinsbindung), number of repayment rates, duration until repayment is complete and the total amount paid. You may only use this API if you display all this data.

 

http://rest.immobilienscout24.de/restapi/api/financing/construction/v1.0/marketdata

Supported media types

  • XML (Accept: application/xml)
  • JSON (Accept: application/json)

Authorization requirements

  • At least a System Key is required for this operation. See Authentication via Two-legged OAuth for further details.

Request

Path Parameters

  • none

Query Paramters

  • purchasePrice - purchase price of the project
  • ownFunds - own funds of the buyer
  • amortizationRate - amortization rate
  • fixedNominalInterestrate - fixed nominal interest rate (FIVE_YEARS, TEN_YEARS, FIFTEEN_YEARS, TWENTY_YEARS)
  • employment - employment of the buyer (CIVIL_SERVANT, EMPLOYED, FREELANCER, PENSIONER, SELFEMPLOYED,UNEMPLOYED)
  • providerType - favored provider types (AGENT, BANK, ALL)
  • geoCode - the region to get the average interest rates from; default: "1276"  (Deutschland) 

1276001 - Baden-Württemberg

1276002 - Bayern

1276003 - Berlin

1276004 - Brandenburg

1276005 - Bremen

1276006 - Hamburg

1276007 - Hessen

1276008 - Mecklenburg-Vorpommern

1276009 - Niedersachsen

1276010 - Nordrhein-Westfalen

1276011 - Rheinland-Pfalz

1276012 - Saarland

1276013 - Sachsen

1276014 - Sachsen-Anhalt

1276015 - Schleswig-Holstein

1276016 - Thüringen

Response

The following section includes the HTTP status code, a short description and examples for the response body content of a successful processed request.
Error responses as well as other simple message responses are described in detail within the common message responses.

  • Status 200 OK
  • The requested operation was successful.

Header

No special headers.

Body

XML

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:marketdata>
    <averageInterestRate>2.07</averageInterestRate>
    <effectiveInterestRate>2.08</effectiveInterestRate>
</ns2:marketdata>

JSON

{
    "ns2:marketdata": {
        "averageInterestRate": "2.07",
        "effectiveInterestRate": "2.08"
    }
}