employees, owners, and tenants
join to Property via property_id; tenants also bridges into Contracts via
floor_area_person_id. creditors is a standalone entity with no property_id column,
referenced from Property and Accounting via creditor_id. See the
Data Model Overview for the complete cross-domain diagram.
Every edge here crosses into another domain — none of the four Stakeholder tables join each
other directly.
person_id isn’t type-consistent across the endpoints that carry it: tenants.person_id
and Accounting.booking_headers.person_id are strings (e.g. "2001-1"), but
Accounting.booking_positions.person_id is an integer with the hyphen stripped — casting
it back to a string doesn’t reproduce the original value. Don’t join booking_positions
to tenants directly on person_id; go via booking_positions.booking_header_id →
booking_headers.person_id instead.creditors
GET /v1/stakeholder/creditors — vendor and creditor master data. This is the only
Stakeholder endpoint without a property_id column — a creditor is a standalone entity that
can serve multiple properties, referenced by creditor_id from Property.technical_objects,
Property.property_creditor_services, Contracts.service_contracts, and
Accounting.booking_headers/booking_positions.
string
required
Unique creditor identifier.
string
Requires the
personal grant.
Primary name line (company or last name).string
Requires the
personal grant.
Secondary name line.string
Creditor type.
string
Requires the
personal grant.
First line of the postal address, above street_address.string
Requires the
personal grant.
Street and house number.string
Requires the
personal grant.
Postal code and city, combined into one field.string
Requires the
personal grant.
Email address.string
Requires the
personal grant.
Website URL. A literal "---" placeholder in the source system is converted to null.string
Requires the
personal grant.
Named contact at the creditor.string[]
Requires the
personal grant.
Phone numbers, up to three per record. Empty entries are omitted.string
Requires the
personal_financial grant.
Bank name.string
Requires the
personal_financial grant.
Bank account IBAN.string
Requires the
personal_financial grant.
BIC code of the creditor’s bank.string
Requires the
personal_financial grant.
Tax identification number.boolean
Whether a construction-withholding-tax exemption certificate
(
Freistellungsbescheinigung, §48b EStG) is on file. Relevant when the creditor performs
construction work.date
Date on the exemption certificate.
string
Industry classification.
string
Additional industry detail.
string
Link to the associated document in the DMS.
employees
GET /v1/stakeholder/employees — the property management team responsible for a property.
string
required
Unique property identifier.
string
Team name responsible for the property.
string
Requires the
personal grant.
Employee first name.string
Requires the
personal grant.
Employee last name.string
Requires the
personal grant.
Contact phone number.string
Requires the
personal grant.
Contact email address.boolean
Whether the employee record is inactive.
This endpoint returns one row per property showing the responsible team/employee — it is
not a general employee directory.
owners
GET /v1/stakeholder/owners — property owner master data, including ownership share for
co-owned properties.
string
required
Unique property identifier.
integer
required
Owner identifier.
Ownership share as a percentage, capped at 100.
null means no share is recorded. A
property can have multiple owners rows that sum to the total share.string
Requires the
personal grant.
Salutation/title.string
Requires the
personal grant.
Owner name (individual or company).string
Requires the
personal grant.
Secondary name line.string
Requires the
personal grant.
Street and house number.string
Requires the
personal grant.
Postal code and city, combined into one field.string
Requires the
personal grant.
Contact phone number.string
Requires the
personal_financial grant.
Bank name.string
Requires the
personal grant.
Fax number.string
Requires the
personal grant.
Contact email address.string
Requires the
personal_financial grant.
BIC code of the owner’s bank.string
Requires the
personal_financial grant.
Bank account IBAN.string
Requires the
personal_financial grant.
The owner’s own bank account number, paired with iban. Unrelated to
Accounting.accounts.account_number, which identifies an account in the chart of
accounts.tenants
GET /v1/stakeholder/tenants — tenant master data and current lease terms.
string
required
Unique property identifier.
string
required
Identifies a tenancy. Shared with
Contracts.contract_debits, Contracts.contract_ends,
and Contracts.index_rent — see the
Data Model Overview for the full join-key
reference.integer
Unit the tenant occupies. Joins to
Property.property_structure.floor_area_id.string
Identifies the tenant. Only valid combined with
property_id, since numbering restarts per
property — see the Data Model Overview.string
Requires the
personal grant.
Full tenant name as a single field. No separate first/last name available.string
Requires the
personal grant.
Primary name line of the tenant’s own contact address, if different from the unit address.string
Requires the
personal grant.
Secondary name line of the tenant’s own contact address.string
Requires the
personal grant.
Street and house number of the tenant’s own contact address.string
Requires the
personal grant.
Postal code and city of the tenant’s own contact address, combined into one field.string
Requires the
personal grant.
Main phone number.string
Requires the
personal grant.
Contact email address.string[]
Requires the
personal grant.
Additional phone numbers, up to three per record — same shape as Stakeholder.creditors.phones.
Empty entries are omitted.string
Requires the
personal_financial grant.
Bank account IBAN.string
Requires the
personal_financial grant.
Bank name.object
The lease period.
date
Lease end date if an extension option is exercised.
date
Deadline by which the extension option can be exercised.
string
Link to the associated document in the DMS.