Parties

A Party represents a legal entity in the facilioo system. It can be an individual, a company, or another organization. Each Party has a type that defines its role in the system and determines available functionality and relationships.

📘
Disclaimer: Party type and AccountRole
The type of a party is currently represented in this API by the AccountRole enum. This naming can be misleading, as it implies a direct connection to the Account entity. In practice, AccountRole defines the type of the Party—not the role of an Account. However, since each Account is associated with a Party, it inherits the AccountRole indirectly through that relationship.

ID	Name (EN)	Name (DE)	Description
`1`	`Admin`	`Admin`	An admin of the platform.
`2`	`Property ManagementCompany`	`Hausverwaltung`	An organization responsible for managing properties.
`3`	`Pool Manager`	`Pool`	A manager of shared service pools, coordinating resources across parties.
`5`	`Contractor`	`Firma`	A third-party service provider, such as a craftsman or technician.
`7`	`User`	`Nutzer:in`	A private individual — usually a tenant, owner, or resident.
`10`	`Energy Provider`	`Versorger`	A utility company supplying energy (e.g. electricity, gas, water).
`11`	`Guest`	`Gast`	A temporary or limited-access user (restricted scope and permissions).
`13`	`Insurance Broker`	`Makler`	A party acting as an intermediary for insurance services.
`14`	`Insurer`	`Versicherer`	A party providing insurance policies.
`15`	`Mediator`	`Vermittler`	A facilitator or intermediary between parties, without being the direct provider or end-user.

Accounts

An Account represents a user’s access to the facilioo system. It includes login credentials and permissions, and is always linked to a Party.

Account-to-Party Relationships

Typically, all legal entities (like Property Management Companies, Contractors, etc.) have one Party, and multiple Accounts for each of their employees.

Meanwhile, Users (e.g., tenants, owners) have a 1:1 relationship between Party and Account. Their Party is typically created and associated with the property managing company’s Party.

Unit Contracts

A Unit Contract describes the relationship between a Party of type User and a Unit. This is how facilioo models roles like tenant, owner, or resident, and determines access rights and communication paths within a building. The known types to represent these roles associated with a unit contract are:

ID	Name (EN)	Name (DE)	Description
`1`	`Board Chairman`	`Beiratvorsitze`	Acts as chair of the owner or cooperative board.
`2`	`Board Member`	`Beiräte`	Member of the property’s board.
`3`	`Owner`	`Eigentümer:innen`	Legal owner of the unit.
`4`	`Tenant`	`Mieter:innen`	Primary leaseholder or renting party.
`5`	`Subtenant`	`Untermieter:innen`	Person subletting the unit from the primary tenant.
`6`	`Resident`	`Bewohner:innen`	Occupant of the unit without ownership or tenancy rights.
`7`	`Special Owner`	`Sondereigentümer:innen`	Non-standard ownership case (e.g., partial ownership).
`8`	`Property Owner`	`Objekteigentümer:innen`	General property-level ownership role.
`9`	`Authorized Owner Recipient`	`Zustellberechtigte Eigentümer:innen`	Delegate authorized to receive documents or notices for owner.
`10`	`Authorized Tenant Recipient`	`Zustellberechtigte Mieter:innen`	Delegate authorized to receive documents or notices for tenant.