Gebäude / Grundstücke

Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.

Hinweise zur Funktion

Grundstücke und Gebäude bilden abgeschlossene Einheiten, welche zusammengenommen eine Wirtschaftseinheit bilden können. Ein Gebäude kann über Nutzungseinheiten verfügen.

Üblicherweise sind die Gebäude und Grundstücke die Adressträger unter den Einheiten.

Gebäude abrufen

Version 1.0

---

get

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

IdNumstring · nullfähigOptional

BuildingLandTypestring · nullfähigOptional

EconomicUnitIdinteger · int32Optional

ConstructionYearinteger · int32 · nullfähigOptional

BuildingTypeIdinteger · int32 · nullfähigOptional

Streetstring · nullfähigOptional

StreetCompletestring · nullfähigOptional

HouseNumberCompletestring · nullfähigOptional

HouseNumberstring · nullfähigOptional

HouseNumberAdditionstring · nullfähigOptional

Zipstring · nullfähigOptional

Townstring · nullfähigOptional

DistrictIdinteger · int32 · nullfähigOptional

CountryIdinteger · int32 · nullfähigOptional

CountryCodestring · nullfähigOptional

MonumentalProtectionTypeIdinteger · int32 · nullfähigOptional

MonumentalProtectionTypestring · nullfähigOptional

EntryDatestring · date · nullfähigOptionalExample: 2026-03-03Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ExitDatestring · date · nullfähigOptionalExample: 2026-03-03Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

MoveInDatestring · date · nullfähigOptionalExample: 2026-03-03Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ExitReasonIdinteger · int32 · nullfähigOptional

ExitReasonstring · nullfähigOptional

ChangeReasonIdinteger · int32 · nullfähigOptional

ChangeReasonstring · nullfähigOptional

OriginIdinteger · int32 · nullfähigOptional

Originstring · nullfähigOptional

EntryReasonIdinteger · int32 · nullfähigOptional

EntryReasonstring · nullfähigOptional

BuildingConstructionMethodIdinteger · int32 · nullfähigOptional

BuildingConstructionMethodstring · nullfähigOptional

BuildingNumberOfStoreysnumber · decimal · nullfähigOptional

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.0/CommercialInventory/BuildingLands

HTTPcURLJavaScriptPython

GET /openwowi/v1.0/CommercialInventory/BuildingLands HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "Id": 1,
    "IdNum": "text",
    "BuildingLandType": "text",
    "EconomicUnitId": 1,
    "ConstructionYear": 1,
    "BuildingTypeId": 1,
    "Street": "text",
    "StreetComplete": "text",
    "HouseNumberComplete": "text",
    "HouseNumber": "text",
    "HouseNumberAddition": "text",
    "Zip": "text",
    "Town": "text",
    "DistrictId": 1,
    "CountryId": 1,
    "CountryCode": "text",
    "MonumentalProtectionTypeId": 1,
    "MonumentalProtectionType": "text",
    "EntryDate": "2026-03-03",
    "ExitDate": "2026-03-03",
    "MoveInDate": "2026-03-03",
    "ExitReasonId": 1,
    "ExitReason": "text",
    "ChangeReasonId": 1,
    "ChangeReason": "text",
    "OriginId": 1,
    "Origin": "text",
    "EntryReasonId": 1,
    "EntryReason": "text",
    "BuildingConstructionMethodId": 1,
    "BuildingConstructionMethod": "text",
    "BuildingNumberOfStoreys": 1
  }
]

---

Version 1.2

---

get

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

managementIdinteger · int32Optional

managementIdNumstringOptional

economicUnitIdinteger · int32Optional

economicUnitIdNumstringOptional

ownerIdinteger · int32Optional

ownerNumberstringOptional

buildingLandIdinteger · int32Optional

buildingLandIdNumstringOptional

buildingLandTypestring · enumOptionalMögliche Werte:

includeCompanyCodebooleanOptionalDefault: false

includeAdditionalFieldbooleanOptionalDefault: false

showNullValuesbooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

IdNumstring · nullfähigOptional

BuildingLandTypestring · enumOptionalMögliche Werte:

EntryDatestring · date · nullfähigOptionalExample: 2026-03-03Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ExitDatestring · date · nullfähigOptionalExample: 2026-03-03Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.2/CommercialInventory/BuildingLands

HTTPcURLJavaScriptPython

GET /openwowi/v1.2/CommercialInventory/BuildingLands HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "Id": 1,
    "IdNum": "text",
    "BuildingLandType": "Building",
    "EntryDate": "2026-03-03",
    "ExitDate": "2026-03-03",
    "EconomicUnit": {
      "Id": 1,
      "IdNum": "text",
      "Name": "text",
      "Location": "text"
    },
    "EstateAddress": {
      "Zip": "text",
      "Town": "text",
      "Street": "text",
      "HouseNumber": "text",
      "HouseNumberAddition": "text",
      "CountryId": 1,
      "CountryCode": "text",
      "StreetComplete": "text",
      "HouseNumberComplete": "text"
    },
    "Land": {
      "LandArea": 1,
      "EntryReason": {
        "Id": 1,
        "Name": "text"
      }
    },
    "Building": {
      "ConstructionYear": 1,
      "MoveInDate": "2026-03-03",
      "BuildingNumberOfStoreys": 1,
      "ConstructionMethod": {
        "Id": 1,
        "Name": "text"
      },
      "BuildingType": {
        "Id": 1,
        "Name": "text"
      },
      "District": {
        "Id": 1,
        "Name": "text"
      },
      "MonumentalProtectionType": {
        "Id": 1,
        "Name": "text"
      },
      "Origin": {
        "Id": 1,
        "Name": "text"
      },
      "ChangeReason": {
        "Id": 1,
        "Name": "text"
      }
    },
    "ExitReason": {
      "Id": 1,
      "Name": "text"
    },
    "AdditionalFields": [
      {
        "Name": "text",
        "Content": "text",
        "Type": "text"
      }
    ]
  }
]

---

Die Enumerationseinträge für "DistrictId" finden Sie in den Objekt-Katalogen. Die Enumerationseinträge für "CountryId" und "CountryCode" finden Sie in den Personen-Katalogen.

Enumerationseinträge für "MonumentalProtectionTypeId" und "MonumentalProtectionType"

Id	MonumentalProtectionType
1	Denkmalschutz (§ 3 DSchG, Einzeldenkmal)
2	erhaltenswerte Bausubstanz (§ 25 DSchG)
3	Erhaltungssatzung (§ 5 DSchG, Denkmalbereich, Ensemble)
4	Gestaltungssatzung gem. § 81 Bauordnung NRW
6	vorläufig unter Schutz gestellt (§ 4 DSchG)