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 · nullableOptional

BuildingLandTypestring · nullableOptional

EconomicUnitIdinteger · int32Optional

ConstructionYearinteger · int32 · nullableOptional

BuildingTypeIdinteger · int32 · nullableOptional

Streetstring · nullableOptional

StreetCompletestring · nullableOptional

HouseNumberCompletestring · nullableOptional

HouseNumberstring · nullableOptional

HouseNumberAdditionstring · nullableOptional

Zipstring · nullableOptional

Townstring · nullableOptional

DistrictIdinteger · int32 · nullableOptional

CountryIdinteger · int32 · nullableOptional

CountryCodestring · nullableOptional

MonumentalProtectionTypeIdinteger · int32 · nullableOptional

MonumentalProtectionTypestring · nullableOptional

EntryDatestring · date · nullableOptionalExample: 2026-04-02Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ExitDatestring · date · nullableOptionalExample: 2026-04-02Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

MoveInDatestring · date · nullableOptionalExample: 2026-04-02Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ExitReasonIdinteger · int32 · nullableOptional

ExitReasonstring · nullableOptional

ChangeReasonIdinteger · int32 · nullableOptional

ChangeReasonstring · nullableOptional

OriginIdinteger · int32 · nullableOptional

Originstring · nullableOptional

EntryReasonIdinteger · int32 · nullableOptional

EntryReasonstring · nullableOptional

BuildingConstructionMethodIdinteger · int32 · nullableOptional

BuildingConstructionMethodstring · nullableOptional

BuildingNumberOfStoreysnumber · decimal · nullableOptional

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-04-02",
    "ExitDate": "2026-04-02",
    "MoveInDate": "2026-04-02",
    "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

includeSubBuildingsbooleanOptionalDefault: false

showNullValuesbooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

IdNumstring · nullableOptional

BuildingLandTypestring · enumOptionalMögliche Werte:

EntryDatestring · date · nullableOptionalExample: 2026-04-02Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ExitDatestring · date · nullableOptionalExample: 2026-04-02Pattern: \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-04-02",
    "ExitDate": "2026-04-02",
    "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-04-02",
      "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"
      },
      "Architect": {
        "Id": 1,
        "PersonId": 1,
        "PersonIdNum": "text",
        "PersonName": "text"
      },
      "Caretaker": {
        "Id": 1,
        "PersonId": 1,
        "PersonIdNum": "text",
        "PersonName": "text"
      },
      "LevelType": {
        "Id": 1,
        "Name": "text"
      },
      "SubBuildings": [
        {
          "Id": 1,
          "IdNum": "text",
          "BuildingLandType": "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)