---
title: "Objekte auflisten"
url: "https://maklerportal.apim.eu/apis/objektverwaltung/versions/725feb93-ed74-4ebf-862d-00afd038d14d/operations/objekteAuflisten"
---

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

# Objekte auflisten

`GET` `/objekte`

Operation ID: `objekteAuflisten`

## Query parameters

- `status` (string, optional)
- `typ` (string, optional)
- `plz` (string, optional) - Filter auf die Postleitzahl.
- `limit` (integer, optional)
- `cursor` (string, optional)

## Responses

- `200` - Trefferliste
- `401` - Schlüssel fehlt, ist gesperrt oder ungültig
- `429` - Rate Limit erreicht

## 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
paths:
  /objekte:
    get:
      tags:
        - Objekte
      summary: Objekte auflisten
      operationId: objekteAuflisten
      parameters:
        - name: status
          in: query
          schema:
            $ref: "#/components/schemas/ObjektStatus"
        - name: typ
          in: query
          schema:
            $ref: "#/components/schemas/Objekttyp"
        - name: plz
          in: query
          description: Filter auf die Postleitzahl.
          schema:
            type: string
            example: "20251"
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
        - name: cursor
          in: query
          schema:
            type: string
      responses:
        "200":
          description: Trefferliste
          content:
            application/json:
              schema:
                type: object
                properties:
                  daten:
                    type: array
                    items:
                      $ref: "#/components/schemas/Objekt"
                  seite:
                    $ref: "#/components/schemas/Seite"
        "401":
          $ref: "#/components/responses/NichtAuthentifiziert"
        "429":
          $ref: "#/components/responses/ZuVieleAnfragen"
security:
  - apiKey: []
components:
  schemas:
    ObjektStatus:
      type: string
      enum:
        - entwurf
        - aktiv
        - reserviert
        - verkauft
        - vermietet
        - archiviert
      example: aktiv
    Objekttyp:
      type: string
      enum:
        - wohnung
        - haus
        - grundstueck
        - gewerbe
        - stellplatz
      example: wohnung
    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
    Seite:
      type: object
      description: Cursor-basierte Paginierung.
      properties:
        anzahl:
          type: integer
          example: 25
        gesamt:
          type: integer
          example: 138
        cursor_naechste:
          type: string
          nullable: true
          example: eyJzIjoyNX0
    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"
    Fehler:
      type: object
      description: Einheitliches Fehlerformat aller Maklerportal-APIs.
      required:
        - code
        - nachricht
      properties:
        code:
          type: string
          example: validierung_fehlgeschlagen
        nachricht:
          type: string
          example: Für die Veröffentlichung fehlen Pflichtangaben aus dem Energieausweis.
        details:
          type: array
          items:
            $ref: "#/components/schemas/Fehlerdetail"
    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
    Fehlerdetail:
      type: object
      properties:
        feld:
          type: string
          example: energieausweis.endenergiebedarf_kwh
        grund:
          type: string
          example: fehlt
  responses:
    NichtAuthentifiziert:
      description: Schlüssel fehlt, ist gesperrt oder ungültig
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Fehler"
    ZuVieleAnfragen:
      description: Rate Limit erreicht
      headers:
        Retry-After:
          schema:
            type: integer
            example: 12
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Fehler"
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >
        Jeder Aufruf trägt einen API-Schlüssel im Header `apikey`. Den Schlüssel

        erzeugen Sie im Maklerportal unter "Meine Anwendungen"; er wird genau
        einmal

        angezeigt.


        An jedem Schlüssel hängen die Scopes, die er nutzen darf. Fehlt einer,

        antwortet die API mit `403` und `code: "scope_fehlt"`; der fehlende
        Scope

        steht in `details[].feld`.
```