Immobilien¶

Die Immobilien-Endpunkte beziehen sich auf Gebäude, die der Charakter direkt besitzt. Eine gemietete Wohnung oder eine Anstellung am Gebäude reicht nicht aus.

Eigene Immobilien¶

Liste¶

GET /building/list

Scopes: building

Liefert alle Immobilien des Charakters.

[
  {
    "id": "65f...",
    "hash": "alta_1",
    "label": "Alta Street",
    "address": "Alta Street 12"
  }
]

Allgemeine Informationen¶

GET /building/details/{buildingId}

Scopes: building, building.details

Liefert Stammdaten und die aktuelle Auslastung einer eigenen Immobilie.

{
  "id": "65f...",
  "hash": "alta_1",
  "label": "Alta Street",
  "address": "Alta Street 12",
  "area": "Los Santos",
  "garageSlots": 10,
  "price": 2500000,
  "totalRooms": 20,
  "occupiedRooms": 14,
  "freeRooms": 6
}

Mieter¶

Premium-Endpunkt

Dieser Endpunkt ist nur mit Premium-Zugriff verfügbar.

GET /building/tenants/{buildingId}

Scopes: building, building.tenants, optional building.tenants.activity

Liefert die Mieter und das jeweils gemietete Zimmer. Mit dem zusätzlichen Scope building.tenants.activity enthält jeder Eintrag außerdem lastPayDate, also den Zeitpunkt der letzten Mietzahlung.

[
  {
    "roomId": "65f...",
    "roomHash": "room_1",
    "roomName": "Zimmer 1",
    "tenantName": "Max Mustermann",
    "lastPayDate": "2026-06-01T12:00:00.000Z"
  }
]

Zimmer¶

GET /building/rooms/{buildingId}

Scopes: building, building.rooms

Liefert alle Zimmer mit Miete, Inneneinrichtung und Belegungsstatus. Bei belegten Zimmern wird bewusst kein Name des Mieters ausgegeben.

Premium-Zusatzinhalt

interiorImage enthält nur mit Premium-Zugriff das Vorschaubild der Inneneinrichtung. Andernfalls ist der Wert null.

[
  {
    "id": "65f...",
    "hash": "room_1",
    "name": "Zimmer 1",
    "rent": 500,
    "occupied": true,
    "interior": "Heruntergekommenes Motelzimmer",
    "interiorImage": "https://static.statev.de/vnet/buildingThumbnails/default.webp",
    "interiorDetails": {
      "inventoryCapacity": 250,
      "kitchenCapacity": 100,
      "wardrobeCapacity": 100
    }
  }
]

Bank¶

Konten¶

Premium-Endpunkt

Dieser Endpunkt ist nur mit Premium-Zugriff verfügbar.

GET /building/bankaccounts/{buildingId}

Scopes: building, building.bankaccount

[
  {
    "id": "65f...",
    "vban": "VB123456",
    "balance": 15250.75,
    "note": "Mietkonto",
    "main": true
  }
]

Transaktionen¶

Premium-Endpunkt

Dieser Endpunkt ist nur mit Premium-Zugriff verfügbar.

GET /building/transactions/{bankId}/{limit?}/{skip?}

Scopes: building, building.bankaccount

limit ist optional, standardmäßig 10 und maximal 25. skip ist optional, standardmäßig 0 und maximal 200.

{
  "totalTransactions": 84,
  "transactions": [
    {
      "senderVban": "VB123456",
      "receiverVban": "VB654321",
      "reference": "Miete",
      "amount": 500,
      "timestamp": "2026-06-05T12:00:00.000Z"
    }
  ]
}