---
title: "Objekt"
url: "https://maklerportal.apim.eu/apis/objektverwaltung/versions/725feb93-ed74-4ebf-862d-00afd038d14d/schemas/Objekt"
---

> Full API specification: https://maklerportal.apim.eu/apis/objektverwaltung/versions/725feb93-ed74-4ebf-862d-00afd038d14d.md

# Objekt

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Objektverwaltung
  version: 1.0.0
servers:
  - url: https://api.maklerportal.example/v1
    description: Produktion
  - url: https://sandbox.api.maklerportal.example/v1
    description: Sandbox
components:
  schemas:
    ObjektAnlegen:
      type: object
      required:
        - typ
        - titel
        - adresse
      properties:
        typ:
          $ref: "#/components/schemas/Objekttyp"
        titel:
          type: string
          maxLength: 120
          example: 3-Zimmer-Altbau am Falkenried
        beschreibung:
          type: string
          example: Gepflegte Altbauwohnung im zweiten Obergeschoss mit zwei Südbalkonen.
        adresse:
          $ref: "#/components/schemas/Adresse"
        wohnflaeche_qm:
          type: number
          format: float
          example: 86.5
        grundstuecksflaeche_qm:
          type: number
          format: float
          example: 412
        zimmer:
          type: number
          format: float
          example: 3
        baujahr:
          type: integer
          example: 1908
        etage:
          type: integer
          example: 2
        kaufpreis_eur:
          type: integer
          example: 645000
        kaltmiete_eur:
          type: integer
          example: 1450
        nebenkosten_eur:
          type: integer
          example: 280
        verfuegbar_ab:
          type: string
          format: date
          example: 2026-11-01
        energieausweis:
          $ref: "#/components/schemas/Energieausweis"
        provision:
          $ref: "#/components/schemas/Provision"
    ObjektStatus:
      type: string
      enum:
        - entwurf
        - aktiv
        - reserviert
        - verkauft
        - vermietet
        - archiviert
      example: aktiv
    Objekttyp:
      type: string
      enum:
        - wohnung
        - haus
        - grundstueck
        - gewerbe
        - stellplatz
      example: wohnung
    Adresse:
      type: object
      required:
        - plz
        - ort
      properties:
        strasse:
          type: string
          example: Falkenried 42
        plz:
          type: string
          pattern: ^[0-9]{5}$
          example: "20251"
        ort:
          type: string
          example: Hamburg
        land:
          type: string
          default: DE
        lage_genauigkeit:
          type: string
          description: Steuert, wie genau die Adresse im Exposé erscheint.
          enum:
            - exakt
            - strasse
            - stadtteil
          default: strasse
    Energieausweis:
      type: object
      description: Kennwerte, die für die Veröffentlichung eines Exposés benötigt werden.
      properties:
        art:
          type: string
          enum:
            - verbrauchsausweis
            - bedarfsausweis
        endenergiebedarf_kwh:
          type: number
          format: float
          example: 118.4
        energietraeger:
          type: string
          example: fernwaerme
        baujahr_anlage:
          type: integer
          example: 1998
        effizienzklasse:
          type: string
          enum:
            - A+
            - A
            - B
            - C
            - D
            - E
            - F
            - G
            - H
        gueltig_bis:
          type: string
          format: date
          example: 2031-04-30
        befreiung:
          type: string
          description: Gesetzt, wenn keine Ausweispflicht besteht.
          enum:
            - denkmalschutz
            - kleingebaeude
    Provision:
      type: object
      properties:
        kaeufer_prozent:
          type: number
          format: float
          example: 3.57
        verkaeufer_prozent:
          type: number
          format: float
          example: 3.57
        hinweis:
          type: string
          example: inkl. gesetzlicher Umsatzsteuer
    Objekt:
      allOf:
        - $ref: "#/components/schemas/ObjektAnlegen"
        - type: object
          properties:
            id:
              type: string
              example: obj_8f2c1a
            status:
              $ref: "#/components/schemas/ObjektStatus"
            medien_anzahl:
              type: integer
              example: 14
            angelegt_am:
              type: string
              format: date-time
              example: 2026-08-14T08:12:44Z
            geaendert_am:
              type: string
              format: date-time
              example: 2026-08-20T09:38:02Z
```