openapi: 3.0.2 info: title: Interhyp Submission commands financing-application API version: 2.0.0 contact: name: Interhyp AG (Team Provider Excellence) email: support_submission_api@interhyp.de license: name: Interhyp AG description: '### This document describes the RESTful API and resources provided by Interhyp AG.
The RESTful API provides access to resources associated to submission process via *URI* paths, a client application will make an HTTP request using standard HTTP methods like *GET, PUT, POST and DELETE* and parse the response in *JSON* format.
### API Audience
The API is intended to be consumed by clients who want to integrate Interhyp submission process in their own workflow. + **Bank Partners** ### API design Principles
During API design a set of principles were taken into consideration. + **API First** + **Mobile First** ### API client
As an API client you should adhere to the following robustness principle
+ **Tolerant Reader** Be tolerant with unknown fields in the payload. This is required to avoid new API versions if new fields were added, i.e. ignore new fields but do not eliminate them from payload if needed for subsequent *PUT* requests
+ Be prepared to handle HTTP status codes not explicitly specified in endpoint definitions.'
servers:
- url: https://api-test.interhyp.de/submission
description: Test-Staging
- url: https://api.interhyp.de/submission
description: Production
security:
- BearerAuth: []
tags:
- name: financing-application
description: provides endpoints for financing application resources not associate to a specific financing partner
paths:
/financing-applications/{financingApplicationId}:
get:
summary: Get a exisiting financing application
description: 'Delivers information about existing financing application
'
operationId: getFinancingApplicationById
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/embed'
responses:
'200':
description: Financing application is returned
content:
application/json:
schema:
$ref: '#/components/schemas/FinancingApplication'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested financing application resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/applicant-relationships:
get:
summary: Get a list of applicant-relationships
description: 'Delivers information about the relationship of the applicants involved in this financing application.
'
operationId: getApplicantRelationshipsByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
responses:
'200':
description: requested applicant relationsships are returned
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicantRelationshipsQuery'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that the financing application resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/applicants:
get:
summary: Get applicants for a specific submission package.
description: Delivers detailed information for applicants associated with this submission.
operationId: getApplicantsByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/embed'
responses:
'200':
description: Requested applicants are returned
content:
application/json:
schema:
$ref: '#/components/schemas/Applicants'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/applicants/{applicantId}:
get:
summary: Get a specific mortgage applicant
description: Delivers detailed information for mortgage applicant by his id.
operationId: getApplicantById
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/applicant-id'
responses:
'200':
description: Requested applicant is returned
content:
application/json:
schema:
$ref: '#/components/schemas/Applicant'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested applicant resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/applicants/{applicantId}/financial-standings:
get:
summary: Get applicant financial standings
description: 'Delivers detailed information about an applicant financial standings associated with this financing application.
Including periodical income, expenses, general equity and debts'
operationId: getFinanceStandingsForApplicant
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/applicant-id'
- $ref: '#/components/parameters/financial-standing-filter'
- $ref: '#/components/parameters/embed'
responses:
'200':
description: Requested applicant financial standings are returned
content:
application/json:
schema:
$ref: '#/components/schemas/FinancialStandings'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/consultation:
get:
summary: Get financing consultation
description: Delivers detailed information about the consultation associated with this financing application.
operationId: getConsultationByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
responses:
'200':
description: Requested financing consultation returned.
content:
application/json:
schema:
$ref: '#/components/schemas/Consultation'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/estates:
get:
summary: Get estates for a specific financing application.
description: Delivers detailed information for the estates associated with this financing application. Estate could have a role as an object to be financed, an equity item or a guarantee (security).
operationId: getEstatesByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/embed'
responses:
'200':
description: Requested estates are returned
content:
application/json:
schema:
$ref: '#/components/schemas/Estates'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested financing application resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/estates/{estateId}:
get:
summary: Get a specific estate.
description: Delivers detailed information for an estate by it's id.
operationId: getEstateById
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/estate-id'
- $ref: '#/components/parameters/financing-application-id'
responses:
'200':
description: Requested estate is returned
content:
application/json:
schema:
$ref: '#/components/schemas/Estate'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested mortgage property resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/financial-standings:
get:
summary: Get applicants financial standings
description: 'Delivers detailed information about the applicants financial standings associated with this financing application as provided by the applicant during the consultation phase.
Including periodical Income, Expenses, General Equity and Debts'
operationId: getFinanceStandingsByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/financial-standing-filter'
- $ref: '#/components/parameters/embed'
responses:
'200':
description: Requested financial standings associated with this financing application are returned.
content:
application/json:
schema:
$ref: '#/components/schemas/FinancialStandings'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/financial-standings/existing-loans/{debtId}:
get:
summary: Get a specific existing loan.
description: Delivers detailed information for existing loan by it's id.
operationId: getExistingLoanById
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/debt-id'
responses:
'200':
description: Requested existing loan is returned
content:
application/json:
schema:
$ref: '#/components/schemas/ExistingLoanDebt'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested existing morgage resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/financial-standings/{financialStandingId}:
get:
summary: Get a specific financial standing
description: 'Delivers detailed information about a specific financial standing associated with this submission package.
Including periodical income, expenses, general equity and debts'
operationId: getFinanceStandingsById
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/financial-standing-id'
responses:
'200':
description: Requested financial standing is returned
content:
application/json:
schema:
$ref: '#/components/schemas/FinancialStanding'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/households:
get:
summary: Get applicants household
description: Delivers detailed information about the applicants households associated with this financing application.
operationId: getHouseholdsByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
responses:
'200':
description: Requested households information are returned.
content:
application/json:
schema:
$ref: '#/components/schemas/HouseholdsQuery'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/informers:
get:
summary: Get consultation informers
description: "Delivers detailed information about the consultation informers associated with this submission.\n\nThis endpoint utilizes *Expansion* feature, where *by default* only basic information shall be returned. In order to access more full details, two options are available\n\n - follow provided links in order to navigate to submission sub-resources (i.e /v2/submissions/{submissionId}/overview)\n\n - initiate the call with request parameter `embed` set to *TRUE* (i.e /v2/submissions/{submissionId}?embed=true)\n\nPlease refer to *Expansion* section for more details."
operationId: getFinancingApplicationInformers
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/embed'
responses:
'200':
description: Requested mortgage informers are returned
content:
application/json:
schema:
$ref: '#/components/schemas/Informers'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/informers/{informerId}:
get:
summary: Get a specific mortgage informer
description: Delivers detailed information for mortgage informer by his id.
operationId: getFinancingApplicationInformerById
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
- $ref: '#/components/parameters/informer-id'
responses:
'200':
description: Requested informer is returned
content:
application/json:
schema:
$ref: '#/components/schemas/Informer'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested informer resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected Error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/offer:
get:
summary: Get financing offer
description: Delivers detailed information about the financing offer associated with this financing application.
operationId: getOfferByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
responses:
'200':
description: Requested financing offer is returned
content:
application/json:
schema:
$ref: '#/components/schemas/FinancingOffer'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/submissions:
get:
summary: Get financing application's submission
description: Delivers detailed information about the submission belong to specific loan partner and associated with this financing application.
operationId: getSubmissionsByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
responses:
'200':
description: Requested Submissions is returned
content:
application/json:
schema:
$ref: '#/components/schemas/Submissions'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
/financing-applications/{financingApplicationId}/venture:
get:
summary: Get financing venture
description: Delivers detailed information about the financing venture associated with this financing application.
operationId: getVentureByFinancingApplicationId
tags:
- financing-application
parameters:
- $ref: '#/components/parameters/financing-application-id'
responses:
'200':
description: Requested financing venture is returned
content:
application/json:
schema:
$ref: '#/components/schemas/FinancingVenture'
'400':
description: Error indicates missing or wrong request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'401':
description: Error indicates no access to the required resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthProblem'
'404':
description: Error indicates that a requested submission resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
'500':
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/RFC7807Problem'
components:
schemas:
EntryMarking:
type: object
description: 'Object to define entry markings like ''the end of the fixed interest rate'' or ''the amortization rate changed to''. The properties ''name'' and ''period'' are required and there can be additional key/value pairs for the specific markings like, ''rate: 3.5%'' for the value of the changed amortization rate if name is ''AMORTIZATION_RATE_CHANGED''.
'
allOf:
- $ref: '#/components/schemas/EntryPeriod'
required:
- name
properties:
name:
description: The name of the marking
$ref: '#/components/schemas/MarkingName'
rate:
description: present if type is 'AMORTIZATION_RATE_CHANGED'
$ref: '#/components/schemas/EuroAmount'
amount:
description: present if type is 'EXTRA_PAYMENT'
$ref: '#/components/schemas/EuroAmount'
AuxiliaryLoan:
description: 'DE: Information zum Nachrangdarlehen.
EN: Information about the auxiliary loan.
'
type: object
required:
- product
allOf:
- $ref: '#/components/schemas/BaseLoan'
properties:
annuityDetails:
$ref: '#/components/schemas/AnnuityDetails'
product:
$ref: '#/components/schemas/AuxProductType'
Contact:
type: object
properties:
phoneNumbers:
type: array
items:
$ref: '#/components/schemas/Phone'
email:
type: string
description: 'DE: E-Mail des Antragstellers
EN: E-Mail of the customer
'
example: primary@example.com
HouseUtilityOwnUnitGroup:
type: object
allOf:
- $ref: '#/components/schemas/BaseHouseUtilityUnitGroup'
AlimonyInfo:
type: object
required:
- alimony
description: 'DE: Informationen über Unterhaltseinkünfte.
EN: Information regarding alimony income.
'
properties:
alimony:
$ref: '#/components/schemas/PeriodicalEuroAmount'
maritalPart:
description: 'DE: Davon: aus Ehegattenunterhalt.
EN: Of which: from spousal aliment.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
childPart:
description: 'DE: Davon: aus Kindesunterhalt.
EN: Of which: from child support.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
PersonName:
type: object
required:
- gender
- firstName
- lastName
properties:
gender:
type: string
description: 'DE: Geschlecht der Person (nicht abschließende Aufzählung), z. B. M=männlich, F=weiblich, D=divers, UNSPECIFIED.
EN: Open ended enum contains gender of the person, possible values are M=male, F=female, D=diverse, UNSPECIFIED.
'
x-extensible-enum:
- M
- F
- D
- UNSPECIFIED
title:
$ref: '#/components/schemas/Title'
firstName:
type: string
description: 'DE: Vorname der Person.
EN: First name of the person.
'
lastName:
type: string
description: 'DE: Nachname der Person.
EN: Last name of the person.
'
maidenName:
type: string
description: 'DE: Geburtsname der Person.
EN: Maiden name of the person.
'
CalculationType:
type: string
description: 'DE: Kalkulationstyp (nicht abschließende Aufzählung), z.B. HOUSEHOLD=Haushaltsrechnung, CONDITION=Konditionskalkulation, LENDING_VALUE=Beleihungswert-Kalkulation
EN: Calculation type - open ended enum contains property type details, possible values are HOUSEHOLD, CONDITION, LENDING_VALUE
'
example: HOUSEHOLD
x-extensible-enum:
- HOUSEHOLD
- CONDITION
- LENDING_VALUE
ExistingModernisations:
type: object
description: 'DE: Information über die durchgeführte Modernisierungen.
EN: Complete information about modernisations that were carried out.
'
properties:
yearOfLastRefurbishment:
description: 'DE: Jahr der letzten Modernisierung.
EN: Year of a the last modernisation.
'
$ref: '#/components/schemas/Year'
yearOfTotalRefurbishment:
description: 'DE: Jahr der Totalsanierung.
EN: Year of a complete modernisation.
'
$ref: '#/components/schemas/Year'
description:
description: 'DE: Beschreibung über die durchgeführte Modernisierungen.
EN: Description of modernisations that were carried out.
'
type: string
totalCosts:
description: 'DE: Gesammte Modernisierungskosten.
EN: Total modernisation costs.
'
$ref: '#/components/schemas/EuroAmount'
breakdown:
description: 'DE: Detailierte Information über die durchgeführte Modernisierungen.
EN: Breakdown (details) about the modernisations that were carried out.
'
items:
$ref: '#/components/schemas/ExistingModernisation'
MaritalPropertyStatusKey:
type: string
description: 'DE: Beschreibung des ehelichen Güterstandes (nicht abschließende Aufzählung, zum Beispiel: COMMUNITY_OF_ACQUESTS_AND_GAINS = ZUGEWINNGEMEINSCHAFT, SEPARATION_OF_PROPERTY = GÜTERTRENNUNG, ABSOLUTE_COMMUNITY_PROPERTY = GÜTERGEMEINSCHAFT).
EN: Open ended enum contains values for the matrimonial property, possible values are COMMUNITY_OF_ACQUESTS_AND_GAINS, SEPARATE_PROPERTY, ABSOLUTE_COMMUNITY_PROPERTY.
'
example: COMMUNITY_OF_ACQUESTS_AND_GAINS
x-extensible-enum:
- COMMUNITY_OF_ACQUESTS_AND_GAINS
- SEPARATE_PROPERTY
- ABSOLUTE_COMMUNITY_PROPERTY
- OTHER
SuspendedAmortizationDetails:
type: object
required:
- rateType
description: 'DE: Information zum Tilgungssurrogat.
EN: Information about the repayment surrogate.
'
allOf:
- $ref: '#/components/schemas/BaseRateDetails'
properties:
type:
$ref: '#/components/schemas/SuspendedRepaymentProductType'
sum:
description: 'DE: Tilgungsbetrag.
EN: Amortisation sum.
'
$ref: '#/components/schemas/EuroAmount'
contractSignedWith:
description: 'DE: Referenz zu den Antragsteller der den Vetrag unterschrieben hat.
EN: Reference to the applicant who signed the contract.
'
$ref: '#/components/schemas/ApplicantIdRef'
contractDuration:
description: 'DE: Vertragsdauer.
EN: Contract duration.
'
$ref: '#/components/schemas/Duration'
upcomingPayments:
$ref: '#/components/schemas/UpcomingPayments'
savingBurden:
$ref: '#/components/schemas/PeriodicalEuroAmount'
depositValue:
$ref: '#/components/schemas/EuroAmount'
contractNumber:
description: 'DE: Vertragsnummer.
EN: Contract number.
'
type: string
combinedProduct:
$ref: '#/components/schemas/SuspendedAmortizationCombinedProduct'
debtId:
description: Id of an existing mortgage saving plan
$ref: '#/components/schemas/DebtId'
amortizationProvider:
description: Amortization product in case of mortgage saving plan or company providing life insurance in case of life insurance
type: string
homePurchaseSavingProvider:
$ref: '#/components/schemas/HomePurchaseSavingProvider'
externalId:
description: id (projection id) used to identify the product used as a suspended amortization in the bank external system
type: string
SelfEmploymentIncome:
type: object
description: 'DE: Informationen über Einkommen aus einer selbststaendigen Taetigkeit (nach Steuern).
EN: Information about self-employment Income (after Tax deduction).
'
required:
- income
properties:
income:
$ref: '#/components/schemas/PeriodicalEuroAmount'
details:
$ref: '#/components/schemas/SelfEmploymentIncomeDetails'
Title:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/TitleKey'
ApplicantItem:
type: object
required:
- applicantRef
- person
properties:
applicantRef:
description: 'DE: Id und Referenz des Antragstellers.
EN: Id and reference of the applicant.
'
$ref: '#/components/schemas/ApplicantIdRef'
person:
description: 'DE: Personendaten des Antragsstellers.
EN: Personal data of the applicant.
'
$ref: '#/components/schemas/Person'
embedded:
description: 'DE: Vollständige Daten des Antragsstellers.
EN: Complete data of the applicant.
'
$ref: '#/components/schemas/Applicant'
MarginDetails:
type: object
required:
- marginCorrection
- margins
properties:
margins:
type: array
items:
$ref: '#/components/schemas/Margin'
marginCorrection:
description: Margen Korrektur; ecision 'Margenkorrektur'
$ref: '#/components/schemas/RawPercentage'
RepaymentPlans:
type: object
required:
- plans
properties:
plans:
type: array
items:
$ref: '#/components/schemas/RepaymentPlan'
ModernisationTypeAndScope:
type: object
description: 'DE: Information über den Typ und Umfang der Modernisierung.
EN: Information about the type and scope of the modernisation.
'
required:
- modernisationType
properties:
modernisationType:
$ref: '#/components/schemas/ModernisationType'
modernisationScope:
$ref: '#/components/schemas/ModernisationScope'
PublicPreFinancing:
type: object
required:
- amount
- type
description: 'DE: Information zu einem Zwischenfinanzierung in Zusammenhang mit einer öffentlichen Vorfinanzierung.
EN: Bridging debt associated with public pre-financing.
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
properties:
type:
description: 'DE: Art der öffentlichen Vorfinanzierung.
EN: Type of the public pre financing.
'
type: string
company:
description: 'DE: Unternehmen, welches die öffentlichen Vorfinanzierung bereitgestellt hat.
EN: Company that provided the pre-financing.
'
type: string
amount:
description: 'DE: Vorfinanzierungsbetrag.
EN: Pre-financing amount.
'
$ref: '#/components/schemas/EuroAmount'
BaseProductCalculation:
type: object
required:
- type
- context
- calculationDate
properties:
type:
$ref: '#/components/schemas/CalculationType'
context:
$ref: '#/components/schemas/CalculationContext'
calculationDate:
description: 'DE: Datum der Kalkulation.
EN: Calculation date.
'
$ref: '#/components/schemas/ISODate'
discriminator:
propertyName: type
RealEstateGuarantees:
type: object
description: 'DE: Bürgschaften für die Immobilie.
EN: Guarantees associated with the real estate.
'
properties:
plannedSell:
description: 'DE: Flag, ob das Immobilienvermögen vor dem Finanzierungsprozess verkauft werden soll.
EN: Flag indicates whether the real estate to be sold before the financing.
'
type: boolean
nullable: true
secureFinancing:
description: 'DE: Flag, ob das Immobilienvermögen als Zusatzsicherheit verwendet werden soll.
EN: Flag indicates whether the real estate to be used to secure the financing.
'
type: boolean
nullable: true
FinancingVentureBuyExisting:
description: 'DE: Information über das Finanzierungsvorhaben für den Kauf einer bestehender Immobilie.
EN: Information about the financing venture to buy an existing property.
'
required:
- financingNeed
- financingDetails
allOf:
- $ref: '#/components/schemas/BaseFinancingVenture'
properties:
financingNeed:
$ref: '#/components/schemas/ForeignEstateFinancingNeed'
financingDetails:
$ref: '#/components/schemas/FinancingDetails'
ForeclosureSale:
description: 'DE: Information über Zwangsversteigerung.
EN: Information about foreclosure sale.
'
type: object
properties:
previousOwner:
$ref: '#/components/schemas/PreviousOwner'
estimatedValue:
description: 'DE: Geschätzte Wert der Immobile.
EN: Estimated property value.
'
$ref: '#/components/schemas/EuroAmount'
auction:
$ref: '#/components/schemas/AuctionInfo'
RegulatoryAuthorityLegalBasisKey:
type: string
description: 'DE: Relevante Rechtsnorm (nicht abschließende Aufzählung), z.B. (34_C_GEWO, 34_I_GEWO siehe auch (https://www.gesetze-im-internet.de/gewo/)).
EN: Open ended enum contains the relevant legal norm, possible values are (34_C_GEWO, 34_I_GEWO).
'
x-extensible-enum:
- 34_C_GEWO
- 34_I_GEWO
EstateBuildingCosts:
description: 'DE: Sammlung aller Kosten, die für den Bau der Immobilie relevant sind.
EN: All costs associated with construction of the property.
'
type: object
required:
- construction
properties:
landPrice:
description: 'DE: Grundstückpreis.
EN: Land price.
'
$ref: '#/components/schemas/EuroAmount'
construction:
description: 'DE: Baukosten.
EN: Construction costs.
'
$ref: '#/components/schemas/EuroAmount'
additional:
description: 'DE: Zusätzliche Kosten.
EN: Additional costs.
'
$ref: '#/components/schemas/EuroAmount'
outside:
description: 'DE: Kosten der Außenanlagen.
EN: Cost of the outdoor facilities.
'
$ref: '#/components/schemas/EuroAmount'
CalculationContext:
type: object
description: 'DE: Kalkulation nach Art des Darlehens.
EN: A set of financing structure contexts, which are associated with this calculation (i.e `Main` or `Nachrang` component)..
'
properties:
components:
type: array
items:
$ref: '#/components/schemas/CalculationContextComponent'
LoanPartnerProcessingUnitId:
description: 'DE: ID der Einheit des Kreditgebers, welche den Kreditantrag bearbeitet.
EN: Id of the loan partner processing unit.
'
required:
- value
properties:
value:
type: string
BaseRealEstateRating:
type: object
description: 'DE: Information laut Immobilionbewertung.
EN: Information from estate evaluation
'
required:
- type
properties:
type:
type: string
marketValue:
description: 'DE: Geschätzter Marktwert.
EN: Estimated market value.
'
$ref: '#/components/schemas/EuroAmount'
marketValueEvaluation:
description: 'DE: Marktwert entsprechend einer Infoquelle (z. B. Sprengnetter).
EN: Market value according to an information source (e.g. Sprengnetter).
'
$ref: '#/components/schemas/MarketValueEvaluation'
discriminator:
propertyName: type
PropertyRegisterMortgage:
description: 'DE: Hyptheken, Grundschulden, Rentenschulden (Eintrag aus der dritten Abteilung des Grundbuchblattes).
EN: Mortgages, land charges, annuities (entry from the third section of the land register sheet).
'
type: object
properties:
serial:
description: 'DE: Laufende Nummer im Grundbuch.
EN: Serial number in land register.
'
type: string
rank:
description: 'DE: Rangstelle im Grundbuch.
EN: Cadastral reference.
'
type: string
inventories:
description: 'DE: Referenzen zu den Einträgen im Bestandsverzeichnis.
EN: References to the entries in the inventory.
'
type: array
items:
$ref: '#/components/schemas/PropertyRegisterInventoryId'
nominalAmount:
description: 'DE: Im Grundbuch eingetragener Betrag.
EN: Amount entered in the land register.
'
$ref: '#/components/schemas/EuroAmount'
cessionClaim:
$ref: '#/components/schemas/CessionClaim'
creditor:
description: 'EN: Creditor DE: Gläubiger
'
type: string
interest:
description: 'EN: Interest DE: Dinglicher Zins
'
$ref: '#/components/schemas/PeriodicalPercentage'
nonRecurringLoanUndertaking:
description: 'EN: One-time value DE: Einmalvalutierung siehe [Einmalvalutierung](https://de.wikipedia.org/wiki/Einmalvalutierungserkl%C3%A4rung)
'
type: boolean
nullable: true
auxiliary:
description: 'EN: Additional services DE: Nebenleistungen
'
$ref: '#/components/schemas/Percentage'
primary:
description: 'DE: Flag um anzuzeigen, ob der Darlehensgeber als vorrangiger Gläubiger im Grundbuch eingetragen ist.
EN: Flag to indicate whether the lender is registered as primary creditor in the land register.
'
type: boolean
nullable: true
typeOfBurden:
type: string
description: 'DE: Art der Belastung.
EN: Type of Burden
'
x-extensible-enum:
- LAND_CHARGE
- MORTGAGE
residualDebt:
description: 'DE: Restschuld.
EN: Residual debt
'
$ref: '#/components/schemas/EuroAmount'
Cursor:
type: object
description: 'A cursor refers to a random string of characters which marks a specific item in a collection of data.
The cursor will always point to the item, however it will be invalidated if the item is deleted or removed.
'
properties:
before:
type: string
description: 'This is the cursor that points to the start of the page of data that has been returned.
'
after:
type: string
description: This is the cursor that points to the end of the page of data that has been returned.
ResourceRef:
required:
- href
properties:
href:
type: string
description: 'DE: Link zu einer spezifischen Ressource.
EN: Link to retrieve a specific resource.
'
example: http://some-domain/some/link/to/somewhere
x-skip-camel-case-check: true
DebtId:
type: object
description: 'DE: ID der Verbindlichkeit.
EN: ID of the associated Debt.
'
required:
- value
properties:
value:
type: string
OpenPropertySale:
type: object
description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit einem Immobilienverkauf.
EN: Information about bridging debt associated with property sale.
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
properties:
debtAmount:
description: 'DE: Aktuelle Grundschuldhöhe.
EN: Current debt amount.
'
$ref: '#/components/schemas/EuroAmount'
residualDebt:
description: 'DE: Aktuelle Restschuld.
EN: Current remaining debt.
'
$ref: '#/components/schemas/EuroAmount'
ApplicationSubTypeKey:
type: string
description: 'DE: Unterkategorie des Antragstyp (nicht abschließende Aufzählung), z.B. (NEW_APPLICANT, PROLONGATION, SUPPLEMENTARY_FINANCING).
EN: Open ended enum contains application sub type, possible values are (NEW_APPLICANT, PROLONGATION, SUPPLEMENTARY_FINANCING).
'
example: NEW_APPLICANT
x-extensible-enum:
- NEW_APPLICANT
- PROLONGATION
- SUPPLEMENTARY_FINANCING
CreditPhasePayout:
properties:
amount:
description: 'DE: Bauspardarlehenssumme.
EN: The loan amount in EUR that is provided by the Bausparkasse.
'
$ref: '#/components/schemas/EuroAmount'
payoutDate:
description: 'DE: Datum der Auszahlungsdatum.
EN: The date on which the credit is paid out.
'
$ref: '#/components/schemas/ISODate'
KfwProgram:
type: object
properties:
key:
deprecated: true
description: '@deprecated: Use field type for the program instead.
'
$ref: '#/components/schemas/KfwProgramKey'
type:
$ref: '#/components/schemas/KfwProgramType'
FinancingVentureBuyNew:
description: 'DE: Information über das Finanzierungsvorhaben für den Kauf einer Neubauimmobilie.
EN: Information about the financing venture to buy a newly built property.
'
required:
- financingNeed
- financingDetails
allOf:
- $ref: '#/components/schemas/BaseFinancingVenture'
properties:
financingNeed:
$ref: '#/components/schemas/ForeignEstateFinancingNeed'
financingDetails:
description: 'DE: Finanzierungsdetails zum Kauf einer Neubauimmobilie.
EN: Financing details relevant for purchase of newly build property.
'
$ref: '#/components/schemas/FinancingDetails'
constructionStartDate:
description: 'DE: Baubeginn des Neubaus.
EN: Construction start date of the newly built property.
'
$ref: '#/components/schemas/ISODate'
HouseholdCalculationCommandIncome:
type: object
required:
- valuation
- entries
properties:
value:
description: Der vom Kunden eingetragene Wert
$ref: '#/components/schemas/PeriodicalRawEuroAmount'
valuation:
description: Der von der Bank angesetzte Wert
$ref: '#/components/schemas/PeriodicalRawEuroAmount'
entries:
type: array
items:
$ref: '#/components/schemas/HouseholdCalculationCommandEntry'
HousingSituation:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/HousingSituationKey'
ExistingModernisation:
type: object
description: 'DE: Information über die durchgeführte und geplante Modernisierungen.
EN: Complete information about carried out and planned modernisations.
'
required:
- modernisationTypeAndScope
- modernisationCost
properties:
modernisationTypeAndScope:
$ref: '#/components/schemas/ModernisationTypeAndScope'
year:
description: 'DE: Jahr der Modernisierung.
EN: Year of modernisation.
'
$ref: '#/components/schemas/Year'
modernisationCost:
description: 'DE: Modernisierungskosten.
EN: Modernisation costs.
'
$ref: '#/components/schemas/EuroAmount'
SpecialHouseCharacteristics:
description: 'DE: Spezielle Nutzung des Hauses.
EN: Special use of the house.
'
type: object
allOf:
- $ref: '#/components/schemas/BaseSpecialRealEstateCharacteristics'
properties:
farm:
description: 'DE: Bauernhof.
EN: Farm.
'
type: boolean
nullable: true
ConsultationInfo:
type: object
deprecated: true
x-replaced-with: Consultation.advisory
required:
- clientAdvisor
description: 'DE: Informationen über die Beratung.
EN: Information about the involved parties in the consultation phase.
'
properties:
clientAdvisor:
$ref: '#/components/schemas/OrganizationUser'
OtherCapitalFinancing:
description: 'DE: Finanzierungsrelevante Information zur Kapitalbeschaffung.
EN: Financing-relevant information about the raising capital need.
'
type: object
required:
- neededLoan
allOf:
- $ref: '#/components/schemas/BaseOwnEstateFinancingNeed'
properties:
neededLoan:
$ref: '#/components/schemas/OtherCapitalNeededLoan'
PropertyRegister:
description: 'DE: [Grundbuchinformationen](http://www.gesetze-im-internet.de/gbvfg/BJNR706370935.html#BJNR706370935BJNG000402307).
EN: Information according to the property / land register (hereinafter referred to as land register).
'
type: object
required:
- cover
properties:
cover:
description: 'DE: Allgemeine Information zum Grundbuchblatt (Aufschrift des Grundbuchblattes).
EN: General information on the land register (title of land register sheet)
'
$ref: '#/components/schemas/RegisterCover'
inventories:
description: 'DE: Grundstück und Eigentum (Bestandsverzeichnis des Grundbuchblattes).
EN: Land and property (inventory of the land register sheet).
'
type: array
items:
$ref: '#/components/schemas/PropertiesRegisterInventory'
owners:
description: 'DE: Derzeitige Eigentümer (Erste Abteilung des Grundbuchblattes).
EN: Current owners (first section of the land register sheet).
'
type: array
items:
$ref: '#/components/schemas/PropertyRegisterOwnerEntry'
restrictions:
description: 'DE: Lasten und Beschränkungen (Zweite Abteilung des Grundbuchblattes).
EN: Burdens and restrictions (second section of the land register sheet).
'
type: array
items:
$ref: '#/components/schemas/PropertyRegisterRestriction'
mortgages:
description: 'DE: Hypotheken, Grundschulden, Rentenschulden (Dritte Abteilung des Grundbuchblattes).
EN: Mortgages, land charges, annuity charges (third section of the land register sheet).
'
type: array
items:
$ref: '#/components/schemas/PropertyRegisterMortgage'
ApplicantIdRef:
type: object
description: 'DE: Id und Referenz des Antragstellers.
EN: Id and reference of the applicant.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
applicantId:
$ref: '#/components/schemas/ApplicantId'
OtherCapitalNeededLoanUsage:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/OtherCapitalNeededLoanUsageKey'
CreditWorthiness:
oneOf:
- $ref: '#/components/schemas/SchufaRating'
discriminator:
propertyName: type
mapping:
SCHUFA: '#/components/schemas/SchufaRating'
Recommendation:
type: object
description: 'DE: Empfehlung des Beraters.
EN: Financing advisor recommendations.
'
properties:
chefsSuggestion:
type: boolean
nullable: true
description: 'DE: Angebot vom Berater empfohlen.
EN: Offer is recommended by the financing advisor.
'
explanation:
type: string
description: 'DE: Erläuterung zur Empfehlung des Beraters.
EN: Explanation of the financing advisor''s recommendation.
'
LoanToValueRatioProductCalculation:
type: object
description: 'DE: Information zu der Kalkulation
EN: Information about the calculation.
'
required:
- type
- feasibility
- lender
allOf:
- $ref: '#/components/schemas/BaseProductCalculation'
properties:
feasibility:
$ref: '#/components/schemas/LoanToValueRatioBreakdown'
conditioning:
$ref: '#/components/schemas/LoanToValueRatioBreakdown'
lender:
type: string
description: Darlehensgeber
SelfEmploymentIncomeDetails:
type: object
description: 'DE: Berechnung des selbstständigen Einkommens.
EN: Calculation of independent (self employment) income.
'
properties:
method:
$ref: '#/components/schemas/SelfEmploymentIncomeMethod'
description:
type: string
description: 'DE: Anmerkungen zur Bilanz.
EN: Notes on the balance.
'
averageNetProfit:
description: 'DE: Durchschn. persönlicher Nachsteuergewinn.
EN: Average after-tax profit.
'
$ref: '#/components/schemas/EuroAmount'
values:
type: array
items:
$ref: '#/components/schemas/SelfEmploymentIncomeItem'
ExtendedPeriodicalSavingsEntry:
type: object
description: Savings plan (Sparplan, Summe Sparplan, letzte Periode Sparplan) including marking for special entries.
allOf:
- $ref: '#/components/schemas/PeriodicalSavingsEntry'
properties:
markings:
type: array
items:
$ref: '#/components/schemas/EntryMarking'
BaseLoan:
type: object
description: 'DE: Information zum Darlehen(-objekt).
EN: Information about the financial loan.
'
required:
- id
- type
- amount
- loanPartner
properties:
id:
$ref: '#/components/schemas/LoanId'
seq:
type: integer
format: int32
deprecated: true
description: '@deprecated: Use field id for identification instead.
'
type:
$ref: '#/components/schemas/LoanType'
amount:
description: 'DE: Darlehnsbetrag (per Tranche).
EN: Loan amount (for loan component).
'
$ref: '#/components/schemas/EuroAmount'
maturity:
description: 'DE: Information zur Sollzinsbindung.
EN: Information about interest rate maturity.
'
$ref: '#/components/schemas/InterestMaturity'
specialRepayment:
$ref: '#/components/schemas/SpecialRepayment'
payout:
$ref: '#/components/schemas/PayoutInfo'
duration:
description: 'DE: Darlehensdauer/Gesamtlaufzeit.
EN: Loan duration.
'
$ref: '#/components/schemas/Duration'
loanPartner:
description: Please use the loanPartnerId instead.
deprecated: true
$ref: '#/components/schemas/LoanPartnerProcessingUnit'
loanPartnerId:
$ref: '#/components/schemas/CompanyId'
financedMortgageProperty:
description: 'DE: Referenz zu einem Beleihungsobjekt.
EN: Reference to a lending object.
'
$ref: '#/components/schemas/EstateRef'
contractNumber:
type: string
description: 'DE: Darlehensnummer / Vertragsnummer.
EN: Loan number / contract number.
'
commission:
$ref: '#/components/schemas/CommissionInfo'
isSecuredByLandRegister:
type: boolean
description: 'DE: Ist das Darlehen grundpfandrechtlich besichert?
EN: Is the loan secured by land register?
'
commitmentInterest:
description: 'DE: Bereitstellungszins.
EN: Periodical commitment interest rate.
'
$ref: '#/components/schemas/PeriodicalPercentage'
eHypCent:
description: 'DE: Platformnutzungsgebühr .
EN: Platform usage fees.
'
$ref: '#/components/schemas/EuroAmount'
isForwardLoan:
type: boolean
discriminator:
propertyName: type
ResponsiblePerson:
type: object
required:
- type
- personName
properties:
type:
$ref: '#/components/schemas/ResponsiblePersonType'
personName:
$ref: '#/components/schemas/PersonName'
contact:
$ref: '#/components/schemas/Contact'
ForeignEstateFinancingDetails:
description: 'DE: Finanzierungsdetails über das Finanzierungvorhaben der Immobilie die erworben wird.
EN: Financing details about financing process associated with the property which is to be acquired.
'
type: object
allOf:
- $ref: '#/components/schemas/BaseFinancingDetails'
properties:
newOwners:
description: 'DE: Eigentümer zum Zeitpunkt der Finanzierung (Erste Abteilung des Grundbuchblattes).
EN: Owner at the time of financing (First Section of the Land Register Page)
'
type: array
items:
$ref: '#/components/schemas/PropertyRegisterOwner'
saleInfo:
$ref: '#/components/schemas/SaleInformation'
vendor:
$ref: '#/components/schemas/EstateVendor'
MaritalStatusKey:
type: string
description: 'DE: Familienstand des Antragstellers (nicht abschließende Aufzählung, zum Beispiel: SINGLE = LEDIG, MARRIED = VERHEIRATET, REGISTERED_PARTNERSHIP = EINGETRAGENE LEBENSPARTNERSCHAFT, WIDOWED = VERWITWET, DIVORCED = GESCHIEDEN, SEPARATED=GETRENNT).
EN: Open ended enum contains values for the marital status, possible values are SINGLE, MARRIED, REGISTERED_PARTNER, WIDOWED, DIVORCED, SEPARATED.
'
example: SINGLE
x-extensible-enum:
- SINGLE
- MARRIED
- REGISTERED_PARTNER
- WIDOWED
- DIVORCED
- SEPARATED
- COHABITING
- OTHER
BaseOwnEstateFinancingNeed:
type: object
required:
- reason
description: 'DE: Finanzierungsbedarf für die eigene Immobilie
EN: Financing need for the own estate.
'
allOf:
- $ref: '#/components/schemas/BaseFinancingNeed'
properties:
reason:
type: string
renovationCosts:
description: 'DE: Werterhaltende Maßnahmen
EN: Value-conserving actions
'
$ref: '#/components/schemas/EuroAmount'
plannedModernisations:
$ref: '#/components/schemas/PlannedModernisations'
reschedulingMortgages:
description: 'DE: Darlehen die umgeschuldet werden sollen
EN: Mortgage which is to be rescheduled
'
type: array
items:
$ref: '#/components/schemas/ExistingMortgageRef'
discriminator:
propertyName: reason
EstateAdditionalCosts:
type: object
properties:
inventoryCosts:
$ref: '#/components/schemas/EuroAmount'
otherCosts:
$ref: '#/components/schemas/EuroAmount'
description:
type: string
InsuranceExpense:
type: object
description: 'DE: Informationen über Ausgaben durch Versicherungen.
EN: Informations related insurance expences.
'
properties:
healthInsurance:
description: 'DE: Private/freiw. gesetzliche Krankenversicherungsbeiträge.
EN: Private/ voluntary statutory health insurance contributions.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
lifeInsurance:
description: 'DE: Private Lebens- und Rentenversicherungsbeiträge.
EN: Private life and pension insurance contributions.
'
$ref: '#/components/schemas/InsuranceBurden'
accidentInsurance:
description: 'DE: Unfallversicherungsbeiträge.
EN: Accident insurance contributions.
'
$ref: '#/components/schemas/InsuranceBurden'
disabilityInsurance:
description: 'DE: Berufsunfähigkeitsversicherungsbeiträge.
EN: Disability insurance contributions.
'
$ref: '#/components/schemas/InsuranceBurden'
UserData:
type: object
properties:
userId:
$ref: '#/components/schemas/UserId'
name:
$ref: '#/components/schemas/PersonName'
contact:
$ref: '#/components/schemas/Contact'
jobTitle:
type: string
SuspendedRepaymentProductTypeKey:
type: string
description: 'DE: Art des Tilgungssurrogats (nicht abschließende Aufzählung), z.B. DT_KAP_LV, DT_KAP_RV, BRIT_KAP_LV, BRIT_KAP_RV, FONDS_LV, FONDS_RV, FONDS_SPAR, BAU_SPAR, OTHER.
EN: Open ended enum contains type of repayment surrogate, possible values are DT_KAP_LV, DT_KAP_RV, BRIT_KAP_LV, BRIT_KAP_RV, FONDS_LV, FONDS_RV, FONDS_SPAR, BAU_SPAR, OTHER.
'
example: DT_KAP_LV
x-extensible-enum:
- DT_KAP_LV
- DT_KAP_RV
- BRIT_KAP_LV
- BRIT_KAP_RV
- FONDS_LV
- FONDS_RV
- FONDS_SPAR
- BAU_SPAR
- OTHER
LoanQuotaTypeKey:
type: string
description: 'DE: Ursprung des Wertes der Darlehensquote (nicht abschließende Aufzählung), z.B. CALCULATED, EXTERNAL.
EN: Open ended enum contains loan quota values, possible values are CALCULATED, EXTERNAL.
'
example: CALCULATED
x-extensible-enum:
- CALCULATED
- EXTERNAL
EstateAdditionalLoan:
description: 'DE: Information über ein bestehendes Darlehen (Hypothek).
EN: Information about the already existing mortgage.
'
type: object
required:
- amount
properties:
amount:
description: 'DE: Darlehenssumme.
EN: Loan amount.
'
$ref: '#/components/schemas/EuroAmount'
description:
type: string
usage:
$ref: '#/components/schemas/EstateAdditionalLoanUsage'
BaseSuspendedAmortizationCombinedProduct:
type: object
required:
- product
properties:
product:
$ref: '#/components/schemas/SuspendedRepaymentProductTypeKey'
discriminator:
propertyName: product
CycleKey:
type: string
description: 'DE: Mögliche Zykluswerte (nicht abschließende Aufzählung), z.B. MONTHLY, QUARTERLY, HALF_YEARLY, ANNUAL, ONE_TIME.
EN: Open ended enum contains possible cycle values, possible values are MONTHLY, QUARTERLY, HALF_YEARLY, ANNUAL, ONE_TIME.
'
example: ANNUAL
x-extensible-enum:
- MONTHLY
- QUARTERLY
- HALF_YEARLY
- ANNUAL
- ONE_TIME
BaseExistingLoanDebt:
type: object
required:
- debtId
- type
description: "DE: Finanzierungsrelevante Darlehen.
EN: Existing loan debt.\n\nAn Existing debt could be any of the following types:\n - EMPLOYMENT\n - PRIVATE\n - MORTGAGE_SAVING_PLAN\n - OTHER\n - PUBLIC\n - SOLVENCY\n - EXISTING_MORTGAGE\n - EXISTING_REALESTATE\n - OPEN_PROPERTY_SALE\n"
properties:
debtId:
description: 'DE: Id der dazugehörenden Schulden.
Die Schulden können mit Hilfe des /v2/financing-applications/{financingApplicationId}/financial-standings/existing-loans/{debtId} abgefragt werden.
EN: Id of the associated Debt.
Debt can be accessed via the respective endpoint. */v2/financing-applications/{financingApplicationId}/financial-standings/existing-loans/{debtId}*
'
$ref: '#/components/schemas/DebtId'
contractNumber:
type: string
description: 'DE: Vertragsnummer.
EN: Contract number.
'
type:
$ref: '#/components/schemas/ExistingDebtType'
expectedFutureBurden:
$ref: '#/components/schemas/DebtExpense'
discriminator:
propertyName: type
UpcomingPayments:
type: object
description: 'DE: Kosten für das Tilgungssurrogat in den Folgeperioden.
EN: Upcoming payments for repayment surrogate product.
'
properties:
upcomingFees:
deprecated: true
description: '@deprecated: Upcoming fees are inadmissible. This was decided by the Federal Court of Justice in its ruling of November 15, 2022.
DE: Höhe der wiederkehrenden Kosten.
EN: Upcoming costs.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
closingFee:
description: 'DE: Abschlussgebühr für das Tilgungssurrogat.
EN: Acquisition fee for the repayment surrogate product.
'
$ref: '#/components/schemas/EuroAmount'
paymentDuration:
description: 'DE: Laufzeit des Tilgungssurrogats.
EN: Duration of the repayment surrogate product.
'
$ref: '#/components/schemas/Duration'
PeriodicalRawPercentage:
description: 'DE: Periodischer Prozentsatz.
EN: Periodical percentage.
'
type: object
required:
- percentage
- cycle
properties:
percentage:
$ref: '#/components/schemas/RawPercentage'
cycle:
$ref: '#/components/schemas/Cycle'
ModernisationTypeKey:
type: string
description: 'DE: Typ der Modernisierung (nicht abschließende Aufzählung), z.B. (ELECTRIC, FASSADE, FLOOR_PLAN=Raumaufteilung, FLOORING=Bodenbeläge, HEATING, INSTALLATION, INSULATION=Wärmedämmung, ROOF, SANITARY=Sanitärobjekte, WINDOW, OTHER, HEAT_PROTECTION = Wärmeschutz, VENTILATION_SYSTEM = Lüftungsanlagen, DIGITAL_ENERGY_OPTIMISATION = Digitale Systeme zur Energieoptimierung).
EN: Open ended enum contains types of modernisation, possible values are (ELECTRIC, FASSADE, FLOOR_PLAN, FLOORING, HEATING, INSTALLATION, INSULATION, ROOF, SANITARY, WINDOW, OTHER, HEAT_PROTECTION, VENTILATION_SYSTEM, DIGITAL_ENERGY_OPTIMISATION).
'
example: ELECTRIC
x-extensible-enum:
- ELECTRIC
- FASSADE
- FLOOR_PLAN
- FLOORING
- HEATING
- INSTALLATION
- INSULATION
- ROOF
- SANITARY
- WINDOW
- OTHER
- HEAT_PROTECTION
- VENTILATION_SYSTEM
- DIGITAL_ENERGY_OPTIMISATION
BaseResidualDebtProtection:
type: object
description: 'DE: Eine Restschuldabsicherung für eine der Tranchen. Wird über die LoanId referenziert, falls es mit einer Tranche verbunden ist.
EN: A residual debt protection for the loans. Will be reference via the loan id, if connected to a loan.
'
required:
- id
- loanPartnerId
- type
properties:
id:
$ref: '#/components/schemas/ResidualDebtId'
loanId:
description: 'DE: Referenz zu der Tranche (wenn vorhanden), welche durch diese Restschuldabsicher abgesichert wird.
EN: Reference to the loan (if available) that will be protected by this residual debt protection.
'
$ref: '#/components/schemas/LoanId'
loanPartnerId:
$ref: '#/components/schemas/CompanyId'
type:
$ref: '#/components/schemas/ResidualDebtProtectionType'
discriminator:
propertyName: type
PaymentTimeKey:
type: string
description: 'DE: Mögliche Zahlungszeit-Arten (nicht abschließende Aufzählung), z.B. ADVANCE=Vorschüssig, ARREARS=Nachschüssig.
EN: Open ended enum contains possible payment time types, possible values are ADVANCE, ARREARS.
'
example: ADVANCE
x-extensible-enum:
- ADVANCE
- ARREARS
FinancingApplicationStatus:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/FinancingApplicationStatusKey'
LoanToValueRatioEntry:
title: LoanToValueRatioEntry
type: object
required:
- name
properties:
name:
type: string
description: Name des Eintrages
hints:
type: array
description: Liste an Hinweisen
items:
type: string
realValue:
description: Der tatsächliche Wert in Euro
$ref: '#/components/schemas/RawEuroAmount'
realValueComposition:
type: string
description: Der vom Scoring ausgegebene, unverarbeitete Text
valuation:
description: Der von der Bank angesetzte Wert in Euro
$ref: '#/components/schemas/RawEuroAmount'
loanId:
$ref: '#/components/schemas/LoanId'
House:
description: 'DE: Zusätzliche Information zu der Immobilie von Typ "HOUSE" (Haus).
EN: Additional Information for the estate with the type "HOUSE".
'
type: object
allOf:
- $ref: '#/components/schemas/RealEstate'
properties:
rating:
$ref: '#/components/schemas/HouseRating'
attic:
$ref: '#/components/schemas/AtticDetail'
basement:
$ref: '#/components/schemas/Basement'
specialCharacteristics:
$ref: '#/components/schemas/SpecialHouseCharacteristics'
separatedByWEG:
description: 'DE: Geteilt nach dem Wohneigentumsgesetz (WEG).
EN: Separated based on the WEG law.
'
type: boolean
nullable: true
x-skip-camel-case-check: true
utilityUnits:
$ref: '#/components/schemas/HouseUtilityUnits'
ResponsiblePersonType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ResponsiblePersonTypeKey'
RentPeriodType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/RentPeriodTypeKey'
VariableIncomeBreakdown:
type: object
description: 'DE: Details über regelmäßige Einnahmen
EN: Breakdown of the periodical income.
'
properties:
bonus:
$ref: '#/components/schemas/BonusIncome'
shift:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Nacht-/Schichtzuschlag.
EN: Additional periodical income through night-/shift allowance.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
overtime:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Überstunden.
EN: Additional periodical income through overtime allowance.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
travelAllowance:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Spesen/Reisekostenbeihilfe.
EN: Additional periodical income through travel allowance.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
commission:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Provisionen.
EN: Additional periodical income through commission allowance.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
CalculationContextComponent:
type: object
properties:
type:
readOnly: true
$ref: '#/components/schemas/LoanType'
loanId:
$ref: '#/components/schemas/LoanId'
NationalityTypeKey:
type: string
description: 'DE: Art der Staatsbürgerschaft (nicht abschließende Aufzählung, zum Beispiel FIRST = Erste Staatsbürgerschaft, SECOND = Zweite Staatsbürgerschaft).
EN: Open ended enum contains values for the Nationality, possible values are (FIRST, SECOND, THIRD).
'
x-extensible-enum:
- FIRST
- SECOND
- THIRD
AuctionInfo:
type: object
description: 'DE: Information zur Immobilienauktion.
EN: Information about the estate auction.
'
properties:
auctionDate:
description: 'DE: Auktionsdatum.
EN: Auction date.
'
$ref: '#/components/schemas/ISODate'
auctionMaxBid:
description: 'DE: Höchstes Auktionsgebot.
EN: Highest auction bid.
'
$ref: '#/components/schemas/EuroAmount'
bidAccepted:
description: 'DE: Flag ob das Angebot schon angenommen wurde.
EN: Indicates if the bid is already accepted.
'
type: boolean
nullable: true
VentureRelevantLoan:
type: object
required:
- amount
- type
description: 'DE: Information über Darlehen die zu Hypothek hinzugefügt werden.
EN: Information about existing loans added to the mortgage.
'
properties:
debtId:
description: 'DE: Id der dazugehörenden Schulden.
Die Schulden können mit Hilfe des /v2/financing-applications/{financingApplicationId}/financial-standings/existing-loans/{debtId} abgefragt werden.
EN: Id of the associated Debt.
Debt can be accessed via the respective endpoint. */v2/financing-applications/{financingApplicationId}/financial-standings/existing-loans/{debtId}*
'
$ref: '#/components/schemas/DebtId'
amount:
description: 'DE: Darlehenssumme.
EN: Loan amount.
'
$ref: '#/components/schemas/EuroAmount'
type:
$ref: '#/components/schemas/VentureRelevantLoanType'
until:
description: 'DE: Ablauf Sollzinsbindung.
EN: Fixed interest rate expiry date.
'
$ref: '#/components/schemas/ISODate'
description:
description: 'DE: Beschreibung für bestehende Darlehen.
EN: Description of the existing loan.
'
type: string
contractNumber:
type: string
description: Contract number.
burden:
description: 'DE: Periodische Rate (z.B. monatliche Rate).
EN: Periodical payment amount (e.g. rate per month).
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
debtor:
description: The existing mortgage saving plan bank.
$ref: '#/components/schemas/Debitor'
RentInfo:
type: object
description: 'DE: Information über die Vermietung.
EN: Rent information.
'
properties:
sustainableRent:
description: 'DE: Nachhaltige Miete pro qm.
EN: Sustainable rent per square meter.
'
$ref: '#/components/schemas/PeriodicalEuroAmountPerSquareMeter'
expectedRent:
description: 'DE: Erwartete Gesamtnettokaltmiete.
EN: Expected total net cold rent.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
expectedRentCommercial:
description: 'DE: Erwartete gewerbliche Nettokaltmiete.
EN: Expected commercial net cold rent.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
expectedRentResidential:
description: 'DE: Erwartete Nettokaltmiete wohnwirtschaftlich.
EN: Expected residential net cold rent.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
garageRent:
description: 'DE: Miete für Garage / Stellplatz.
EN: Rent for garage / parking space.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
VentureRelevantLoanType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/VentureRelevantLoanTypeKey'
ClientAdvisor:
type: object
description: 'DE: Informationen über den Endkundenberater.
EN: Information about the customer sales advisor.
'
required:
- userId
properties:
userId:
$ref: '#/components/schemas/ClientAdvisorId'
personName:
$ref: '#/components/schemas/PersonName'
contact:
$ref: '#/components/schemas/Contact'
BasePropertyRegisterOwner:
type: object
description: 'DE: Information über den Eigentümer.
EN: Information about property owner.
'
required:
- type
properties:
type:
description: 'DE: Eigentümertyp.
EN: Owner type.
'
type: string
x-extensible-enum:
- APPLICANT
- THIRD_PERSON
discriminator:
propertyName: type
BaseBridgingLoanDetails:
type: object
required:
- neededAmount
- reason
description: 'DE: Information zur Zwischenfinanzierung.
EN: Details about bridging loan.
'
properties:
reason:
type: string
description: 'DE: Grund für die Zwischenfinanzierung (nicht abschließende Aufzaehlung), z.B. OPEN_PROPERTY_SALE, CLOSED_PROPERTY_SALE, UNAVAILABLE, PUBLIC_PRE_FINANCE, EXISTING_BUILDING_SAVING_PLAN.
EN: Open ended enum contains bridging loan debt reason, possible values are OPEN_PROPERTY_SALE, CLOSED_PROPERTY_SALE, UNAVAILABLE, PUBLIC_PRE_FINANCE, EXISTING_BUILDING_SAVING_PLAN.
'
example: OPEN_PROPERTY_SALE
x-extensible-enum:
- OPEN_PROPERTY_SALE
- CLOSED_PROPERTY_SALE
- UNAVAILABLE
- PUBLIC_PRE_FINANCE
- EXISTING_BUILDING_SAVING_PLAN
neededAmount:
description: 'DE: Zwischenfinanzierungsbetrag.
EN: Bridging loan amount.
'
$ref: '#/components/schemas/EuroAmount'
equityAvailabilityDate:
description: 'DE: Verfügbarkeit des Kapitals.
EN: Bridging loan availability date.
'
$ref: '#/components/schemas/ISODate'
discriminator:
propertyName: reason
OwnershipInventory:
description: 'DE: Eigentum an einem Gründstück/Objekt.
EN: Ownership of a property.
'
type: object
allOf:
- $ref: '#/components/schemas/BasePropertiesRegisterInventory'
properties:
inventoryUnitProperties:
description: 'DE: Sammlung von Sondereigentümen (https://de.wikipedia.org/wiki/Sondereigentum) die mit diesem Miteigentum verbunden sind.
EN: Collection of special properties (inventory units) associated with this co-ownership.
'
type: array
items:
$ref: '#/components/schemas/InventorySpecialProperty'
HouseUtilityUnitGroups:
type: object
description: 'DE: Detail zu beschreibenden Wohneinheiten. Die Beschreibung der Wohneinheiten erfolgt in Gruppen.
EN: Detail to be described residential units. The residential units can be described in groups.
'
properties:
numberOfUnitGroups:
type: integer
format: int32
breakdown:
$ref: '#/components/schemas/HouseUtilityUnitGroupsBreakdown'
PayoutInfo:
type: object
description: 'DE: Information zur Auszahlung des Darlehens.
EN: Loan payout information.
'
properties:
firstPayout:
description: 'DE: Datum der ersten Teilauszahlung.
EN: First payout date.
'
$ref: '#/components/schemas/ISODate'
freeAllocationPeriod:
description: 'DE: Bereitstellungszinsfreie Zeit.
EN: Interest free period.
'
$ref: '#/components/schemas/Duration'
payoutRate:
description: 'DE: Auszahlungskurs.
EN: Payout rate.
'
$ref: '#/components/schemas/Percentage'
PhoneType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PhoneTypeKey'
FinancingApplicationReason:
type: string
description: 'DE: Finanzierungsgründe (nicht abschließende Aufzählung), z.B. BUY_NEW, BUY_EXISTING, BUILD, REFINANCE, RENOVATE, RAISE_CAPITAL.
EN: Open ended enum contains type of the financing reason, possible values are BUY_NEW, BUY_EXISTING, BUILD, REFINANCE, RENOVATE, RAISE_CAPITAL.
'
example: BUY_EXISTING
x-extensible-enum:
- BUY_NEW
- BUY_EXISTING
- BUILD
- REFINANCE
- RENOVATE
- RAISE_CAPITAL
PeriodicalEuroAmountPerSquareMeter:
description: 'DE: Euro Betrag pro Quadratmeter in einem bestimmten Zeitraum.
EN: Euro amount per square meter for a specific period.
'
type: object
required:
- periodicalAmount
properties:
periodicalAmount:
$ref: '#/components/schemas/PeriodicalEuroAmount'
SelfEmploymentIncomeMethod:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/SelfEmploymentIncomeMethodKey'
DebtExpense:
type: object
description: 'DE: Details über bereits existierende Kreditausgaben.
EN: Information about periodical expenses associated with existing loans.
'
required:
- debtId
- burden
properties:
debtId:
$ref: '#/components/schemas/DebtId'
burden:
$ref: '#/components/schemas/PeriodicalEuroAmount'
PropertyRegisterInventoryId:
type: object
required:
- id
description: 'DE: Laufende Nummer eines Grundstücks/Eigentum.
EN: Serial number of the property.
'
properties:
id:
type: string
FinancialVentureItem:
type: object
description: 'DE: Relevante Information zu dem geplanten Finanziehrungsvorhaben.
EN: Information about planed financing venture.
'
required:
- _href
- reason
- mortgageProperty
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
reason:
$ref: '#/components/schemas/FinancingApplicationReason'
mortgageProperty:
description: 'DE: Referenz zum Beleihungsobjekt/Finanzierungsobjekt auf welches sich das Finanzierungsvorhaben bezieht.
EN: The Financing Asset / Property to which the financing venture relates.
'
$ref: '#/components/schemas/EstateRef'
mainApplicant:
description: 'DE: Referenz zum Hauptantragssteller auf den sich das Finanzierungsvorhaben bezieht.
EN: Reference to the financing process related main applicant.
'
$ref: '#/components/schemas/ApplicantIdRef'
embedded:
description: 'DE: Komplette Information über das Finanzierungsvorhaben.
EN: Complete information about the financing venture.
'
$ref: '#/components/schemas/FinancingVenture'
HouseholdsQuery:
type: object
description: 'A wrapper Type to hold a set of households associated with the financing application.
'
properties:
data:
type: array
minItems: 1
items:
$ref: '#/components/schemas/Household'
Utilization:
description: 'DE: Wrapper für Nutzung des Ojektes
EN: Wrapper for utilization of the property.
'
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/UtilizationKey'
PropertyRegisterOwnerEntry:
type: object
description: 'DE: Eigentümer (Eintrag aus der zweiten Abteilung des Grundbuchblattes).
EN: Owner (entry from the second section of the land register sheet).
'
properties:
owners:
description: 'DE: Sammlung von Eigentümer eines Grundstücks. EN: Collection of owners of the property.
'
type: array
items:
$ref: '#/components/schemas/PropertyRegisterOwner'
inventories:
description: 'DE: Referenzen zu den Einträgen im Bestandsverzeichnis.
EN: References to the entries in the inventory.
'
type: array
items:
$ref: '#/components/schemas/PropertyRegisterInventoryId'
HouseUnitCommercialUsage:
type: object
properties:
commerceType:
$ref: '#/components/schemas/HouseUnitCommerceType'
description:
type: string
Salary:
type: object
required:
- net
description: 'DE: Informationen über das Gehalt.
EN: Information regarding salary.
'
properties:
gross:
description: 'DE: Regelmäßiges Lohn und Gehalt (brutto).
EN: Periodical gross salary.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
net:
description: 'DE: Regelmäßiges Lohn und Gehalt (netto).
EN: Periodical net salary.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
numberOfPayments:
type: number
format: double
description: 'DE: Anzahl an Gehaltszahlungen.
EN: Number of payments
'
assuredNumber:
type: number
format: double
description: 'DE: Vertraglich zugesicherte Gehaltszahlungen (wenn numberOfPayments > 12).
EN: Annually secured number of salaries as per employment contract (if numberOfPayments > 12)
'
OwnEstateFinancingDetails:
description: 'DE: Finanzierungsdetails über das Finanzierungvorhaben der bereits besessenen Immobilie.
EN: Financing details about financing process associated with already owned property.
'
type: object
allOf:
- $ref: '#/components/schemas/BaseFinancingDetails'
properties:
acquisitionYear:
description: 'DE: Jahr der Zahlung / Jahr der Fertigstellung.
EN: Purchase / completion year.
'
$ref: '#/components/schemas/Year'
FinancialStandingType:
type: string
description: 'DE: Finanzstatus (nicht abschließende Aufzählung), z.B. (EQUITY, DEBT, INCOME, EXPENSE).
EN: Open ended enum contains possible types financial standing, possible values are (EQUITY, DEBT, INCOME, EXPENSE).
'
example: EQUITY
x-extensible-enum:
- EQUITY
- DEBT
- INCOME
- EXPENSE
HouseUnitCommerceTypeKey:
type: string
description: 'DE: Mögliche Gewerbearten. z.B. RETAIL, MEDICAL_PRACTICE, etc..
EN: Open ended enum contains commerce business line , possible values are (RETAIL, MEDICAL_PRACTICE, etc..).
'
x-extensible-enum:
- RETAIL
- MEDICAL_PRACTICE
- OFFICE
- WORKSHOP
- WAREHOUSE
- GASTRONOMY
- HOTEL
- VIDEO_STORE
- NIGHT_CLUB
- EROTIC
- GAS_STATION
- BETTING_SHOP
- FITNESS_STUDIO
- TAXI
- TRANSPORT
- CONSTRUCTION
- BARBAR
- OTHER
- UNKNOWN
AdvisoryDetails:
type: object
required:
- clientAdvisor
- broker
- brokeragePlatform
description: 'DE: Informationen über die Beratung.
EN: Information about the involved parties in the consultation phase
'
properties:
clientAdvisor:
description: 'DE: Daten des Endkundekontakt.
EN: Information about the client contact person.
'
$ref: '#/components/schemas/ClientAdvisor'
subBrokers:
type: array
description: 'DE: Untervermittler des Antrags.
EN: sub brokers.
'
items:
$ref: '#/components/schemas/OrganizationUser'
broker:
description: 'DE: Daten des Vermittlers.
EN: Information about the main Broker (Interhp, Prohyp, MLP Hyp or Prohyp-WhiteLabel-Partner).
'
$ref: '#/components/schemas/OrganizationUser'
brokeragePlatform:
description: 'DE: Vermittlerplattform.
EN: Brokerage Platform
'
$ref: '#/components/schemas/BrokeragePlatform'
ResponsiblePersonTypeKey:
type: string
description: 'DE: Rolle der zuständigen Person (nicht abschließende Aufzählung), z.B. (PROCESSOR=Ansprechpartner, MANAGER=Führungskraft).
EN: Open ended enum contains the role of the responsible person , possible values are (PROCESSOR, MANAGER)
'
x-extensible-enum:
- PROCESSOR
- MANAGER
FinancingApplication:
type: object
required:
- id
- applicants
- venture
- financialStanding
- estates
properties:
id:
$ref: '#/components/schemas/FinancingApplicationId'
status:
$ref: '#/components/schemas/FinancingApplicationStatus'
subType:
$ref: '#/components/schemas/ApplicationSubType'
applicantRelationships:
$ref: '#/components/schemas/ApplicantRelationships'
applicants:
$ref: '#/components/schemas/Applicants'
households:
$ref: '#/components/schemas/Households'
estates:
$ref: '#/components/schemas/Estates'
financialStanding:
$ref: '#/components/schemas/FinancialStandings'
venture:
$ref: '#/components/schemas/FinancialVentureItem'
consultation:
$ref: '#/components/schemas/ConsultationItem'
consultationInfo:
$ref: '#/components/schemas/ConsultationInfo'
offer:
$ref: '#/components/schemas/FinancingOfferItem'
PeriodicalCreditEntry:
type: object
allOf:
- $ref: '#/components/schemas/EntryPeriod'
- $ref: '#/components/schemas/CreditEntry'
BuildingRepaymentPlan:
type: object
description: The repayment plan of the credit phase.
required:
- entries
- entriesAggregated
properties:
entries:
description: The array of credit entries (Tilgungsplan).
type: array
items:
$ref: '#/components/schemas/ExtendedPeriodicalCreditEntry'
entriesAggregated:
$ref: '#/components/schemas/CreditEntry'
FinancingApplicationStatusKey:
type: string
description: 'DE: Status des Finanzierungsantrages.
EN: Status of the application.
'
x-extensible-enum:
- QUALIFIED_FOR_SUBMISSION
- SUBMITTED
Informers:
type: object
description: 'A wrapper Type to hold a set of financing informer involved in the consultation phase.
'
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/InformerItem'
ResidualDebtProtectionType:
type: string
description: 'DE: Art der Restschuldabsicherung (nicht abschließende Aufzählung), z.B. BUILDING_SAVING_PLAN.
EN: Open ended enum contains possible residual debt protection types, possible values are BUILDING_SAVING_PLAN.
'
example: BUILDING_SAVING_PLAN
x-extensible-enum:
- BUILDING_SAVING_PLAN
InformerId:
type: object
required:
- value
description: 'DE: ID des Zuträgers.
EN: Informer id.
'
properties:
value:
type: string
Furnishing:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/FurnishingKey'
LeaseInfo:
type: object
description: 'DE: Information über ein Erbbaurecht.
EN: Estate leasehold information.
'
required:
- leasehold
properties:
leasehold:
description: 'DE: Flag ob Erbbaurecht vorhanden ist.
EN: Flag to indicate if leasehold exists.
'
type: boolean
discriminator:
propertyName: leasehold
mapping:
true: '#/components/schemas/LeaseHold'
false: '#/components/schemas/NoLeaseHold'
BaseUnionInfo:
type: object
description: 'DE: Informationen zu Verbands- bzw. Gewerkschaftszugehörigkeit EN: Information regarding union membership
'
required:
- membershipId
- organisation
properties:
organisation:
type: string
description: 'DE: Gewerkschafts-Verband
EN: union organisation
'
x-extensible-enum:
- VERDI
- IG_BAU
- NGG
- DBB
- DBWV
- THW_NRW
- OTHER
membershipId:
type: string
maxLength: 100
description: 'DE: Mitgliedsnummer in der Gewerkschaft. EN: membership id for the union.
'
discriminator:
propertyName: organisation
BridgingFinancingMainProduct:
type: object
description: 'DE: Information zur Zwischenfinanzierung im Annuitätendarlehen.
EN: Information on the bridging financing product in the annuity product.
'
allOf:
- $ref: '#/components/schemas/BaseMainProduct'
properties:
details:
$ref: '#/components/schemas/BridgingLoanDetails'
FinancingVentureOtherCapitalFinancing:
description: 'DE: Information über das Finanzierungsvorhaben bei der Kapitalbeschaffung.
EN: Information about the financing venture for capital raising goal.
'
required:
- financingNeed
- financingDetails
allOf:
- $ref: '#/components/schemas/BaseFinancingVenture'
properties:
financingNeed:
$ref: '#/components/schemas/OwnEstateFinancingNeed'
financingDetails:
$ref: '#/components/schemas/FinancingDetails'
PlanTemplate:
type: string
description: 'Describes the repayment plan template based on the conditions of the corresponding loan. - standard: until the end of the fixed interest rate - lifetime: until full repayment - variable_12: 12 months for loans with variable interest rate
'
x-extensible-enum:
- STANDARD
- LIFETIME
- VARIABLE_12
EntryPeriod:
type: object
description: The date object for a cashflow entry.
required:
- period
properties:
period:
description: Period in either day, month, year or quarter format, eg. 2021-08-01, 2021-08, 2021 or 2021-Q3
pattern: ^(\d{4}-\d{2}-\d{2})|(\d{4}-\d{2})|(\d{4})|(\d{4}-(Q\d))$
type: string
HousingSituationKey:
type: string
description: 'DE: Art der derzeitigen Wohnsituation (nicht abschließende Aufzaehlung), z.B. (RENT=zur Miete, RATE=im Eigentum mit Darlehensrate, DEBT_FREE=im abbezahlten Eigentum, PARENTS=mietfrei bei den Eltern/Partner, OWN_PROPERTY=im Eigentum, FIRST_APPLICANT=in einer Eigentumswohnung).
EN: Open ended enum contains value for the current housing/accomodation types, possible values are (RENT, RATE, DEBT_FREE, PARENTS, OWN_PROPERTY, FIRST_APPLICANT).
'
example: RENT
x-extensible-enum:
- RENT
- RATE
- DEBT_FREE
- PARENTS
- OWN_PROPERTY
- FIRST_APPLICANT
- OTHER
ModernisationScope:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ModernisationScopeKey'
PropertyRegisterOwnerThirdPerson:
type: object
allOf:
- $ref: '#/components/schemas/BasePropertyRegisterOwner'
properties:
fullName:
type: string
person:
$ref: '#/components/schemas/Person'
PropertyRegisterRestriction:
description: 'DE: Lasten und Beschränkungen (Eintrag aus der zweiten Abteilung des Grundbuchblattes).
EN: Loads and restrictions (entry from the second section of the land register sheet).
'
type: object
properties:
inventories:
description: 'DE: Referenzen zu den Einträgen im Bestandsverzeichnis.
EN: References to the entries in the inventory.
'
type: array
items:
$ref: '#/components/schemas/PropertyRegisterInventoryId'
restriction:
description: 'DE: Beschreibung der Lasten und Beschränkungen.
EN: Description of burdens and restrictions.
'
type: string
isRestricted:
description: 'DE: Flag, um anzugeben, ob die Eigenschaft eingeschränkt ist.
EN: Flag to indicate whether property is restricted.
'
type: boolean
effectiveAfterMortgages:
description: 'DE: Tritt die Last/Beschränkung im Rang zurück. D. h. indiziert ob eine mögliche Grundschuld im Rang vor dieser Last/Beschränkung steht
EN: Resets the burden/limitation in rank. I.e. indicates if there is a possible land charge ranking before this burden/restriction.
'
type: boolean
nullable: true
PropertyLocation:
description: 'DE: Information über die Lage der Immobilie.
EN: Information about the estate location.
'
type: object
properties:
neighbourhood:
$ref: '#/components/schemas/Neighbourhood'
negativeEffectsInNeighbourhood:
description: 'DE: Sammlung von negativen Einflussfaktoren in der Umgebung.
EN: Collection of negative effects caused by location.
'
type: array
example: 'DE: Liegt in unmittelbarer Nähe einer Autobahn.
EN: Lies in close distance of a highway.
'
items:
type: string
x-is-plural: true
locationInhabitants:
description: 'DE: Einwohnerzahl.
EN: Number of inhabitants.
'
$ref: '#/components/schemas/Inhabitants'
PropertyRegisterOwnerApplicant:
type: object
required:
- applicant
allOf:
- $ref: '#/components/schemas/BasePropertyRegisterOwner'
properties:
applicant:
$ref: '#/components/schemas/ApplicantIdRef'
PlannedModernisation:
type: object
description: 'DE: Information über die geplante Modernisierungen.
EN: Information about planed modernisations.
'
required:
- planedCosts
properties:
modernisationTypeAndScope:
$ref: '#/components/schemas/ModernisationTypeAndScope'
planedCosts:
description: 'DE: Geplanten Modernisierungskosten.
EN: Planed modernisation costs.
'
$ref: '#/components/schemas/EuroAmount'
valueAddingCosts:
description: 'DE: Kosten für die wertsteigernden Modernisierungsmaßnahmen.
EN: Costs associated with value adding modernisations.
'
$ref: '#/components/schemas/EuroAmount'
kfwRelevant:
type: boolean
nullable: true
description: 'DE: KFW Förderungsrelevante Modernisierung
EN: modernisation has an impact on KfW subsidies
'
modernisationDetails:
type: array
items:
$ref: '#/components/schemas/PlannedModernisationDetails'
FinancingApplicationId:
description: 'DE: ID des Finanzierungsantrages
EN: Financing Application identifier
'
type: object
required:
- value
properties:
value:
type: string
UnavailableEquity:
type: object
required:
- investmentType
- investmentAmount
description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit nicht verfügbaren Eigenkapital.
EN: Bridging Debt associated with unavailable equity
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
properties:
investmentType:
description: 'DE: Art der Kapitalbeteiligung.
EN: Type of the equity investment.
'
type: string
investmentCompany:
description: 'DE: Unternehmen in welches das Kapital investiert wurde.
EN: Company in which the equity is invested.
'
type: string
investmentAmount:
description: 'DE: Investionsbetrag.
EN: Investment amount.
'
$ref: '#/components/schemas/EuroAmount'
ApartmentFloor:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ApartmentFloorKey'
LoanId:
type: object
description: 'DE: ID des Darlehens.
EN: Loan identifier.
'
properties:
value:
type: string
ApplicantRelationshipType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ApplicantRelationshipTypeKey'
PensionIncomeBreakdown:
type: object
description: 'DE: Details über die für den Rentenanspruch releventen Daten.
EN: Breakdown for Pension entitlement details.
'
properties:
claimState:
description: 'DE: Rentenanspruch gesetzlich.
EN: Public pension entitlement.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
claimInsurance:
description: 'DE: Rentenanspruch aus privaten Lebens- und Rentenversicherungsbeiträgen.
EN: Pension entitlement from private life and pension insurance contributions.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
SelfEmploymentIncomeMethodKey:
type: string
description: 'DE: Berechnungsmethode für das Einkommen (nicht abschließende Aufzaehlung), z.B. (CUSTOMER_SPECIFICATION=Kundenangabe, PROFIT_AND_LOSS_ACCOUNT=Gewinn- und Verlustrechnung, NO_METHOD).
EN: Open ended enum contains method for profit calculation, possible values are (CUSTOMER_SPECIFICATION, PROFIT_AND_LOSS_ACCOUNT, NO_METHOD).
'
example: CUSTOMER_SPECIFICATION
x-extensible-enum:
- CUSTOMER_SPECIFICATION
- PROFIT_AND_LOSS_ACCOUNT
- NO_METHOD
- OTHER
Informer:
type: object
description: 'DE: Informationen über den Zuträger.
EN: Information about informer.
'
properties:
informerId:
$ref: '#/components/schemas/InformerId'
externalId:
type: string
description: External Informer-ID
person:
$ref: '#/components/schemas/PersonName'
contact:
$ref: '#/components/schemas/Contact'
address:
$ref: '#/components/schemas/Address'
company:
type: string
description: 'DE: Firma des Zuträgers.
EN: Company of the informer.
'
ClientAdvisorId:
type: object
required:
- value
description: 'DE: ID des Users.
EN: ID of a user.
'
properties:
value:
type: string
PhoneTypeKey:
type: string
description: 'DE: Art der Telefonnummer (nicht abschließende Aufzählung, zum Beispiel: MOBILE = Mobilfunknummer, LANDLINE = Festnetznummer, UNSPECIFIED = nicht angegeben, MOBILE_WORK= Firmenhandynummer).
EN: Type of the phone number, possible values are MOBILE, LANDLINE, UNSPECIFIED, MOBILE_WORK.
'
x-extensible-enum:
- MOBILE
- LANDLINE
- UNSPECIFIED
- MOBILE_WORK
OrganizationUser:
type: object
description: 'DE: Informationen über den Benutzer. EN: Information about the user.
'
properties:
userData:
$ref: '#/components/schemas/UserData'
company:
$ref: '#/components/schemas/OrganizationCompany'
PensionIncome:
type: object
required:
- pension
description: 'DE: Regelmäßiges Einkommen aus Rente/Pension.
EN: Periodical income from pension.
'
properties:
pension:
$ref: '#/components/schemas/PeriodicalEuroAmount'
breakdown:
$ref: '#/components/schemas/PensionIncomeBreakdown'
HouseUnitCommerceType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/HouseUnitCommerceTypeKey'
Occupation:
oneOf:
- $ref: '#/components/schemas/Employment'
- $ref: '#/components/schemas/OtherOccupation'
- $ref: '#/components/schemas/SelfEmployment'
- $ref: '#/components/schemas/Executive'
discriminator:
propertyName: type
mapping:
EMPLOYEE: '#/components/schemas/Employment'
WORKER: '#/components/schemas/Employment'
UNEMPLOYED: '#/components/schemas/OtherOccupation'
OFFICIAL: '#/components/schemas/Employment'
PARENTAL_LEAVE: '#/components/schemas/Employment'
FREELANCER: '#/components/schemas/SelfEmployment'
MARGINALLY_EMPLOYED: '#/components/schemas/Employment'
STOCKHOLDER: '#/components/schemas/OtherOccupation'
HOUSE_WIFE_OR_HUSBAND: '#/components/schemas/OtherOccupation'
INDEPENDENT_GENTLEMAN: '#/components/schemas/OtherOccupation'
SELF_EMPLOYED_WITH_BALANCING: '#/components/schemas/SelfEmployment'
SELF_EMPLOYED_WITHOUT_BALANCING: '#/components/schemas/SelfEmployment'
PENSIONER: '#/components/schemas/OtherOccupation'
STUDENT: '#/components/schemas/OtherOccupation'
SOLDIER: '#/components/schemas/Employment'
EXECUTIVE: '#/components/schemas/Executive'
HouseUtilityUnitGroup:
oneOf:
- $ref: '#/components/schemas/HouseUtilityOwnUnitGroup'
- $ref: '#/components/schemas/HouseUtilityRentedUnitGroup'
discriminator:
propertyName: utilization
mapping:
SELF_OCCUPIED: '#/components/schemas/HouseUtilityOwnUnitGroup'
RENT_OUT: '#/components/schemas/HouseUtilityRentedUnitGroup'
PercentageSpecialRepayment:
description: 'DE: Sondertilgung in Prozent pro Periode.
EN: Special repayment presented as percent per period.
'
type: object
required:
- percent
allOf:
- $ref: '#/components/schemas/BaseSpecialRepayment'
properties:
description:
description: 'DE: Beschreibung der Sondertilgung.
EN: Special repayment description.
'
type: string
percent:
description: 'DE: Sondertilgung in Prozent.
EN: Payment percent per period.
'
$ref: '#/components/schemas/PeriodicalPercentage'
LoanPlan:
type: object
required:
- entries
- entriesAggregated
properties:
entries:
type: array
items:
$ref: '#/components/schemas/PeriodicalRepaymentEntry'
entriesAggregated:
$ref: '#/components/schemas/RepaymentEntriesAggregated'
CompanyVendor:
type: object
required:
- company
- vendorType
allOf:
- $ref: '#/components/schemas/BaseVendor'
properties:
company:
type: string
description: 'DE: Name der Firma, für welche der Immobilienverkäufer arbeitet.
EN: The name of the estate vendor company.
'
Submissions:
type: object
description: 'A wrapper Type to hold a set of submission references and paging metadata.
'
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/SubmissionItem'
paging:
$ref: '#/components/schemas/Paging'
BaseFinancialStanding:
type: object
required:
- financialStandingId
- applicantId
- type
description: "DE: Bonitätsdaten des Antragstellers welche während der Beratungsphase gesammelt wurden.\n - Eigenkapital\n - Schulden\n - Einkommen\n - Ausgaben\nEN: Financial Standing as provided by the applicant during the consultation phase.\nA Financial Standing could be any of the following types:\n - EQUITY\n - DEBT\n - INCOME\n - EXPENSE\n"
properties:
financialStandingId:
$ref: '#/components/schemas/FinancialStandingId'
applicantId:
description: 'DE: Ein Referenz wem die Bonitätinformation gehören.
EN: Reference to whom belongs this financial standing.
'
$ref: '#/components/schemas/ApplicantIdRef'
type:
$ref: '#/components/schemas/FinancialStandingType'
discriminator:
propertyName: type
RemainingDebtAtComponent:
type: object
required:
- loanId
- remainingDebt
properties:
loanId:
$ref: '#/components/schemas/LoanId'
remainingDebt:
$ref: '#/components/schemas/RawEuroAmount'
AnnuityDetails:
description: 'DE: Detaillierte Information über das Annuitätsdarlehen.
EN: Detailed information about periodic loan.
'
type: object
required:
- rateType
allOf:
- $ref: '#/components/schemas/BaseRateDetails'
properties:
amortisationRate:
description: 'DE: Tilgungsrate (Prozent pro Periode).
EN: Amortisation rate (percent per period).
'
$ref: '#/components/schemas/PeriodicalPercentage'
fullAmortizer:
type: boolean
description: 'DE: Volltilger.
EN: Full Amortizer.
'
CreditPhaseBurden:
type: object
properties:
creditBurden:
description: 'DE: Darlehensrate.
EN: The credit rate.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
lastCreditBurden:
description: 'DE: Schlussrate.
EN: The last credit rate.
'
$ref: '#/components/schemas/EuroAmount'
totalRatesPayed:
description: 'DE: Zins- und Tilgungsbeiträge insgesamt (inkl. Sondertilgungen).
EN: Sum of all payments made during credit phase.
'
$ref: '#/components/schemas/EuroAmount'
numberOfCreditBurdens:
description: 'DE: Anzahl der Zins- und Tilgungsbeiträge (inkl. Schlussrate).
EN: Number of payed burdens including the last one.
'
type: integer
format: int32
RegulatoryAuthority:
description: 'DE: Die Zuständige Aufsichtsbehörde der Firma.
EN: Responsible supervisory authority of the company.
'
type: object
properties:
legalBasis:
$ref: '#/components/schemas/RegulatoryAuthorityLegalBasis'
name:
description: 'DE: Name der Aufsichtsbehörde.
EN: Name of the responsible supervisory authority.
'
type: string
addressSummary:
description: 'DE: Adresse der Aufsichtsbehörde.
EN: Address of the responsible supervisory authority.
'
type: string
url:
type: string
description: 'DE: Internetseite der Aufsichtsbehrde.
EN: Website of the responsible supervisory authority.
'
ProductCalculation:
oneOf:
- $ref: '#/components/schemas/LoanToValueRatioProductCalculation'
- $ref: '#/components/schemas/HouseholdProductCalculation'
- $ref: '#/components/schemas/ConditionProductCalculation'
discriminator:
propertyName: type
mapping:
LENDING_VALUE: '#/components/schemas/LoanToValueRatioProductCalculation'
HOUSEHOLD: '#/components/schemas/HouseholdProductCalculation'
CONDITION: '#/components/schemas/ConditionProductCalculation'
CommissionCalculationInfo:
type: object
required:
- percent
description: 'DE: Abschließende Information zur Provision.
EN: Complete information about commissions.
'
properties:
percent:
description: 'DE: Provision in Prozent.
EN: Commision in percent.
'
$ref: '#/components/schemas/RawPercentage'
amount:
description: 'DE: Provisionsbetrag.
EN: Provision amount.
'
$ref: '#/components/schemas/RawEuroAmount'
type:
type: string
x-extensible-enum:
- TOTAL
- INTERNAL
- EXTERNAL
- ON_TOP
BaseVendor:
type: object
required:
- vendorType
properties:
vendorType:
type: string
description: 'DE: Art des Immobilienverkäufers (nicht abschließende Aufzählung), z.B. (PERSON, COMPANY).
EN: open ended enum contains type of the vendor, possible values are (PERSON, COMPANY).
'
example: PERSON
x-extensible-enum:
- PERSON
- COMPANY
contact:
$ref: '#/components/schemas/Contact'
address:
$ref: '#/components/schemas/Address'
discriminator:
propertyName: vendorType
Iban:
type: object
description: 'DE: IBAN
EN: The International Bank Account Number
'
required:
- value
properties:
value:
type: string
example: DE46500210000010130383
FinancingNeedType:
type: string
example: OWN
x-extensible-enum:
- OWN
- FOREIGN
AlimonyExpense:
type: object
required:
- alimony
description: 'DE: Ausgaben durch Unterhalt.
EN: Expenses for alimony.
'
properties:
alimony:
description: 'DE: Gesamte Unterhaltsausgaben.
EN: Total alimony expenses
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
details:
type: array
items:
$ref: '#/components/schemas/AlimonyExpenseDetail'
AuxProductType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/AuxProductTypeKey'
CapitalIncome:
type: object
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Kapitalvermögen.
EN: Additional periodical income from capital.
'
properties:
capitalYield:
description: 'DE: Regelmäßige Kapitalerträge (z.B. Zinsen, Dividenden).
EN: Regular investment income (e.g. interest, dividends).
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
stocksAndBondsIncome:
description: 'DE: Regelmäßige Einkünfte aus Beteiligungen (z.B. GmbH-Anteil).
EN: Regular income from stock and bonds investments (e.g. GmbH share)
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
rentalIncomes:
type: array
items:
$ref: '#/components/schemas/RentalIncomeItem'
SaleInformation:
type: object
description: 'DE: Information über den Objektverkauf.
EN: Object sale information.
'
properties:
familySale:
description: 'DE: Verkauf findet innerhalb der Familie statt.
EN: Sold within family.
'
type: boolean
nullable: true
fractionalOwnership:
description: 'DE: Bruchteileigentum.
EN: Fractional Ownership.
'
type: boolean
nullable: true
forcedSale:
$ref: '#/components/schemas/ForeclosureSale'
constructionCostInvoice:
$ref: '#/components/schemas/ConstructionCostInvoice'
KfwProgramType:
type: string
description: 'DE: KFW-Förderprogramm (nicht abschließende Aufzählung), z.B. KFW_124, KFW_151, KFW_152, KFW_153, KFW_159, KFW_167.
EN: Open ended enum contains possible programs for Kfw, i.e. KFW_124, KFW_151, KFW_152, KFW_153, KFW_159, KFW_167.
'
example: KFW_124
x-extensible-enum:
- KFW_124
- KFW_151
- KFW_152
- KFW_153
- KFW_159
- KFW_167
- KFW_261
- KFW_262
- KFN_297
- KFN_QNG_297
- KFN_298
- KFN_QNG_298
- WEP_300
- WEP_QNG_300
- WEP_JKA_308
- KFW_358
- KFW_359
- KNN_296
- UNKNOWN
SubmissionId:
type: object
description: 'An Id refers to a specific submission resource.
'
required:
- value
properties:
value:
type: string
SpecialRepayment:
oneOf:
- $ref: '#/components/schemas/PercentageSpecialRepayment'
- $ref: '#/components/schemas/TextSpecialRepayment'
discriminator:
propertyName: type
mapping:
PERCENTAGE: '#/components/schemas/PercentageSpecialRepayment'
TEXT: '#/components/schemas/TextSpecialRepayment'
RealEstateEquityDetails:
type: object
required:
- equity
description: 'DE: Informationen zum Eigenkapital durch Immobilienvermögen.
EN: Details about equites associated with the real estate.
'
properties:
equity:
description: 'DE: Marktwert.
EN: Market value.
'
$ref: '#/components/schemas/EuroAmount'
PersonVendor:
type: object
required:
- person
- vendorType
allOf:
- $ref: '#/components/schemas/BaseVendor'
properties:
person:
$ref: '#/components/schemas/Person'
PhoneReachabilityKey:
type: string
description: 'DE: Erreichbarkeit unter dieser Telefonnumer (nicht abschließende Aufzählung, zum Beispiel: DAYTIME = tagsüber, EVENING = abends).
EN: Reachable by this phone number, possible values are DAYTIME, EVENING.
'
x-extensible-enum:
- DAYTIME
- EVENING
FinancialStandingItem:
type: object
description: 'Holds basic information associated with a specific financial standing type and whom it belongs.
Further details will be delivered in the embedded property if specified.
Please refer to *Expansion* section for more details.
'
properties:
financialStandingRef:
$ref: '#/components/schemas/FinancialStandingRef'
type:
$ref: '#/components/schemas/FinancialStandingType'
applicantId:
description: 'DE: Ein Referenz wem die Bonitätinformation gehören.
EN: Reference to whom belongs this financial standing.
'
$ref: '#/components/schemas/ApplicantIdRef'
embedded:
$ref: '#/components/schemas/FinancialStanding'
ISODateTime:
description: 'DE: Datum, Syntax nach RFC 3339
EN: Date according to RFC 3339
'
type: string
format: date-time
nullable: true
example: 2019-12-29 10:22:50+00:00
BaseHouseUtilityUnitGroup:
type: object
required:
- utilization
properties:
numberOfUnits:
type: integer
format: int32
description: 'DE: Anzahl der näher zu beschreibenden Wohneinheiten in einer Gruppe.
EN: Number of units within a unit group.
'
totalArea:
$ref: '#/components/schemas/SquareMeter'
vacantArea:
$ref: '#/components/schemas/SquareMeter'
smallestArea:
$ref: '#/components/schemas/SquareMeter'
commercialUsage:
$ref: '#/components/schemas/HouseUnitCommercialUsage'
utilization:
type: string
description: 'DE: Nutzung des Ojektes (nicht abschließende Aufzählung), z.B. SELF_OCCUPIED, RENT_OUT.
EN: Open ended enum contains utilization of the property, possible values are SELF_OCCUPIED, RENT_OUT.
'
x-extensible-enum:
- SELF_OCCUPIED
- RENT_OUT
discriminator:
propertyName: utilization
LoanQuota:
type: object
description: 'DE: Wert und Prozentsatz für die Darlehensquote.
EN: Value and percentage for a loan quota
'
required:
- type
properties:
type:
$ref: '#/components/schemas/LoanQuotaType'
lendingValue:
description: 'DE: Beleihungswert.
EN: Lending value.
'
$ref: '#/components/schemas/EuroAmount'
percentage:
description: 'DE: Beleihungsauslauf.
EN: Loan quota percentage.
'
$ref: '#/components/schemas/Percentage'
conditional:
description: 'DE: Beleihungsauslauf für die Konditionermittlung.
EN: Loan quota for condition retrieval.
'
$ref: '#/components/schemas/Percentage'
HouseRentedUnitDetails:
type: object
properties:
rentedPeriod:
$ref: '#/components/schemas/RentPeriodType'
rent:
$ref: '#/components/schemas/PeriodicalEuroAmount'
sustainableRent:
description: 'DE: Nachhaltige Miete pro qm.
EN: Sustainable rent per square meter.
'
$ref: '#/components/schemas/PeriodicalEuroAmountPerSquareMeter'
rentValuation:
description: 'DE: Mietewert entsprechend einer Infoquelle (z. B. Sprengnetter).
EN: Rent value according to an information source (e.g. Sprengnetter).
'
$ref: '#/components/schemas/EvaluationInformation'
FinancingVenture:
oneOf:
- $ref: '#/components/schemas/FinancingVentureBuyNew'
- $ref: '#/components/schemas/FinancingVentureBuyExisting'
- $ref: '#/components/schemas/FinancingVentureConstruction'
- $ref: '#/components/schemas/FinancingVentureDebtRescheduling'
- $ref: '#/components/schemas/FinancingVentureRenovation'
- $ref: '#/components/schemas/FinancingVentureOtherCapitalFinancing'
discriminator:
propertyName: reason
mapping:
BUY_NEW: '#/components/schemas/FinancingVentureBuyNew'
BUY_EXISTING: '#/components/schemas/FinancingVentureBuyExisting'
BUILD: '#/components/schemas/FinancingVentureConstruction'
REFINANCE: '#/components/schemas/FinancingVentureDebtRescheduling'
RENOVATE: '#/components/schemas/FinancingVentureRenovation'
RAISE_CAPITAL: '#/components/schemas/FinancingVentureOtherCapitalFinancing'
MaritalStatus:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/MaritalStatusKey'
OfferId:
type: object
required:
- value
properties:
value:
type: string
revision:
type: string
description: Offer revision that has been currently submitted
ExistingLoanExpenses:
type: object
description: 'Wrapper Type holds a set of periodical expenses associated with existing credits.
'
properties:
credits:
type: array
items:
$ref: '#/components/schemas/DebtExpense'
MaritalPropertyStatus:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/MaritalPropertyStatusKey'
SelfEmployment:
type: object
allOf:
- $ref: '#/components/schemas/BaseOccupation'
properties:
jobInformation:
$ref: '#/components/schemas/JobInformation'
foundationYear:
description: 'DE: Jahr der Gründung der Unternehmung
EN: Year of the foundation of the enterprise
'
example: 1999
$ref: '#/components/schemas/Year'
shareHolding:
$ref: '#/components/schemas/ShareHolding'
freelancerJobType:
$ref: '#/components/schemas/FreeLancerJobType'
ExistingMortgageRef:
type: object
description: 'DE: Id und Referenz zu einer bestehenden Hypothek.
EN: Id and reference to the existing mortgage.
'
required:
- id
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
id:
$ref: '#/components/schemas/DebtId'
PhoneReachability:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PhoneReachabilityKey'
DefaultSpecialRealEstateCharacteristics:
allOf:
- $ref: '#/components/schemas/BaseSpecialRealEstateCharacteristics'
BridgingLoanDetails:
oneOf:
- $ref: '#/components/schemas/OpenPropertySale'
- $ref: '#/components/schemas/ClosedPropertySale'
- $ref: '#/components/schemas/UnavailableEquity'
- $ref: '#/components/schemas/PublicPreFinancing'
- $ref: '#/components/schemas/ExistingBuildingSavingPlan'
discriminator:
propertyName: reason
mapping:
OPEN_PROPERTY_SALE: '#/components/schemas/OpenPropertySale'
CLOSED_PROPERTY_SALE: '#/components/schemas/ClosedPropertySale'
UNAVAILABLE: '#/components/schemas/UnavailableEquity'
PUBLIC_PRE_FINANCE: '#/components/schemas/PublicPreFinancing'
EXISTING_BUILDING_SAVING_PLAN: '#/components/schemas/ExistingBuildingSavingPlan'
Address:
type: object
required:
- city
- country
properties:
street:
type: string
example: Mainsteet
description: 'DE: Straßenname (Teil der Adresse).
EN: Street name of the address
'
houseNumber:
type: string
example: '42'
description: 'DE: Hausnummer (Teil der Adresse).
EN: House number of the address.
'
apartmentNumber:
type: string
example: '3'
description: 'DE: Wohnungsnummer.
EN: Apartment number within the building.
'
postalCode:
type: string
example: '80807'
description: 'DE: Postleitzahl (Teil der Adresse).
EN: Postal code of the address.
'
city:
type: string
example: Munich
description: 'DE: Stadt (Teil der Adresse). EN: City of the address.
'
federalState:
type: string
example: DE_BY
description: 'DE: Bundesland (Teil der Adresse) nach nach ISO 3166-2 (https://en.wikipedia.org/wiki/ISO_3166-2).
EN: Federal state of the address in ISO_3166-2 format (https://en.wikipedia.org/wiki/ISO_3166-2).
'
country:
type: string
example: DE
description: 'DE: Länder-Code (Teil der Adresse) nach ISO_3166-1_alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
EN: Official ISO_3166-1_alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the address.
'
BasementExtensionForResidentialUse:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/BasementExtensionForResidentialUseKey'
FinancialDebt:
type: object
required:
- type
description: 'DE: Informationen über (finanzielle) Schulden vor Beginn der angefragten Finanzierung.
EN: Financial debts information before the financing process.
'
allOf:
- $ref: '#/components/schemas/BaseFinancialStanding'
properties:
liability:
$ref: '#/components/schemas/LiabilityDebt'
existingLoans:
type: array
description: 'DE: Alle laufenden Schulden aus Darlehen.
EN: Set of current loans debts.
'
items:
$ref: '#/components/schemas/ExistingLoanDebt'
other:
$ref: '#/components/schemas/EuroAmount'
RenovateEstateFinancing:
description: 'DE: Finanzierungsrelevante Information zum Umbau / Modernisierung.
EN: Financing-relevant information for the refurbishment / modernisation.
'
allOf:
- $ref: '#/components/schemas/BaseOwnEstateFinancingNeed'
BaseForeignEstateFinancingNeed:
type: object
required:
- reason
description: 'DE: Finanzierungsbedarf für den Kauf oder Bau einer Immobilie
EN: Financing need for buying or building an estate.
'
allOf:
- $ref: '#/components/schemas/BaseFinancingNeed'
properties:
reason:
type: string
estateAcquisitionCosts:
$ref: '#/components/schemas/EstateAcquisitionCosts'
discriminator:
propertyName: reason
AuxiliaryIncome:
type: object
required:
- income
description: 'DE: Regelmäßige Nebeneinkünfte.
EN: Periodical auxiliary income.
'
properties:
income:
$ref: '#/components/schemas/PeriodicalEuroAmount'
since:
$ref: '#/components/schemas/ISODate'
BusinessLineKey:
type: string
description: 'DE: Branche der Tätigkeit (nicht abschließende Aufzählung).
EN: Open ended enum contains values for the business line, possible values are AGRICULTURE, CAR_DEALER, CAR_REPAIR, CHURCH, CONSTRUCTION_INDUSTRY, COURIER_SERVICE, DATING_SERVICE, EDUCATION, ENERGY, EROTIC_INDUSTRY, FINANCES, FINANCIAL_SERVICES, FITNESS, GAS_STATION, GASTRONOMY, HANDCRAFT, HEALTH_SERVICE, HOTEL_INDUSTRY, IT_CONSULTING, KIOSK, OTHER, PRODUCTION_AND_INDUSTRY, PUBLIC_SERVICE, REAL_ESTATE, TAXI, TRANSPORT, TRAVEL_AGENCY, WHOLE_AND_RETAIL_SALE.
'
example: AGRICULTURE
x-extensible-enum:
- AGRICULTURE
- ADMINISTRATION
- AUTOMOTIVE
- CAR_DEALER
- CAR_REPAIR
- CHURCH
- CONSTRUCTION_INDUSTRY
- CONSULTING_AND_ADVISORY
- COURIER_SERVICE
- DATING_SERVICE
- EDUCATION
- ENERGY
- EROTIC_INDUSTRY
- FINANCES
- FINANCIAL_SERVICES
- FITNESS
- GAS_STATION
- GASTRONOMY
- HANDCRAFT
- HAULIER
- HEALTH_SERVICE
- HOTEL_INDUSTRY
- IT_CONSULTING
- IT_AND_PROGRAMMING
- KIOSK
- PRODUCTION_AND_INDUSTRY
- PUBLIC_SERVICE
- REAL_ESTATE
- TAXI
- TRANSPORT
- TRAVEL_AGENCY
- WHOLE_AND_RETAIL_SALE
- MINING
- CHEMICAL_INDUSTRY
- DIPLOMATIC_SERVICE
- PRINTING_INDUSTRY
- FISHING_INDUSTRY
- WOOD_INDUSTRY
- IRON_INDUSTRY
- CAR_MANUFACTURER
- MILITARY
- FOOD_INDUSTRY
- NON_PROFIT_ORGANISATION
- MEDIA_INDUSTRY
- SEAFARING
- LOGISTIC
- TEXTILE_INDUSTRY
- TOURISM
- MANUFACTURING_INDUSTRY
- PASSENGER_TRANSPORT
- TEMP_EMPLOYMENT_AGENCY
- VIDEO_STORE
- OTHER
KfwCallTypeKey:
type: string
description: 'DE: Art der KFW-Reservierung (nicht abschließende Aufzählung), z.B. LIGHT, PLUS.
EN: Open ended enum contains Kfw reservation process call type, possible values are LIGHT, PLUS.
'
example: PLUS
x-extensible-enum:
- LIGHT
- PLUS
- OTHER
RFC7807Problem:
type: object
title: RFC7807Problem
description: 'DE: Angaben zum zurueckgegebenen Fehler. EN: Holds information on the returned error.
'
required:
- timestamp
- traceId
- instance
- title
- status
properties:
timestamp:
type: string
format: date-time
description: 'DE: Ein UTC-Zeitstempel, der den Fehlerzeitpunkt angibt (https://de.wikipedia.org/wiki/Koordinierte_Weltzeit). EN: A UTC date-time indicating the error timestamp (https://en.wikipedia.org/wiki/Coordinated_Universal_Time).
'
example: 2024-06-29 19:22:50+00:00
type:
type: string
format: uri
description: 'DE: Verknuepfung zum Abruf von mehr Informationen zu dem Fehler. EN: URL referring to more information about the error.
'
default: about:blank
title:
type: string
description: 'DE: Kurzbeschreibung des Fehlers. EN: Error short description.
'
example: Bad Request
status:
type: integer
format: int32
description: 'DE: HTTP-Status-Code gemaess Konvention (https://tools.ietf.org/html/rfc2616#section-10). EN: HTTP status code following standared error codes (https://tools.ietf.org/html/rfc2616#section-10).
'
example: 400
minimum: 100
maximum: 599
detail:
type: string
description: 'DE: Detaillierte Beschreibung des Fehlers. EN: Detailed description for the returned error.
'
example: JSON parse error
traceId:
type: string
description: 'DE: Eindeutige Kennung zur Verfolgung der Anfrage. EN: Unique trace id for problematic request.
'
example: avx1234asd
instance:
type: string
format: uri
description: 'DE: Pfad zur betreffenden Resource. EN: Path of requested resource.
'
example: http://localhost/resources/123
violations:
type: array
description: 'DE: Abfolge der Verstoesse in der Anfrage. EN: Collection of the invalid content of the request.
'
items:
$ref: '#/components/schemas/Violation'
AtticDetail:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/AtticDetailKey'
FreeLancerJobTypeKey:
type: string
description: 'DE: Freiberufliche Tätigkeit des Antragstellers (nicht abschließende Aufzählung).
EN: open ended enum contains alues for the freelancer job types, possible values are CARER, AMBORDERLY, ADVOCATE, APOTHECARY, ARCHITECT, PHYSICIAN, UNDERTAKER, ACCOUNTANT, REVISOR, FED_DP_COMMISSIONER, DECORATOR, DIETICIAN, INTERPRET, ERGOTHERAPIST, NUTRITIONIST, GEOGRAPHER, CONSULTANT, IT_CONSULT, FINANCSERV, PHOTOGRAPH, DESIGNER, MIDWIFE, HEALERMASSEUR, HEALER, HISTORIAN, COMPUTER_SPEC, ENGINEER, INSOLVENCY_ADMIN, JOURNALIST, PHYSIOTHER, ORDERLY, NURSE, MUSICIAN, CONSTRUCTOR, THERAPIST, MASSEUR, PARAMEDIC, NOTARY, OPTICIAN, OPERA_SINGER, HR_ADVISR, PSYCHOLOG, PSYCHOTHER, PHYSTHERAP, INTER_DECORATOR, RADIO_ANNOUNCER, EXPERT, TOWN_PLANER, STRUCT_ENG, TAX_ADVISR, TAX_AGENT, VETERINARY, TRANSLATOR, UNDER_ADVISR, AUDITOR, DENTAL_TECH, DENTIST, FARMER, OTHER.
'
example: ARCHITECT
x-extensible-enum:
- CARER
- AMBORDERLY
- ADVOCATE
- APOTHECARY
- ARCHITECT
- PHYSICIAN
- UNDERTAKER
- ACCOUNTANT
- REVISOR
- FED_DP_COMMISSIONER
- DECORATOR
- DIETICIAN
- INTERPRET
- ERGOTHERAPIST
- NUTRITIONIST
- GEOGRAPHER
- CONSULTANT
- IT_CONSULT
- FINANCSERV
- PHOTOGRAPH
- DESIGNER
- MIDWIFE
- HEALERMASSEUR
- HEALER
- HISTORIAN
- HR_CONSULTANT
- COMPUTER_SPEC
- ENGINEER
- INSOLVENCY_ADMIN
- JOURNALIST
- PHYSIOTHER
- ORDERLY
- NURSE
- MUSICIAN
- CONSTRUCTOR
- THERAPIST
- MASSEUR
- PARAMEDIC
- NOTARY
- OPTICIAN
- OPERA_SINGER
- HR_ADVISR
- PSYCHOLOG
- PSYCHOTHER
- PHYSTHERAP
- INTER_DECORATOR
- RADIO_ANNOUNCER
- REMEDIAL_GYMNAST
- EXPERT
- TOWN_PLANER
- STRUCT_ENG
- TAX_ADVISR
- TAX_AGENT
- VETERINARY
- TRANSLATOR
- UNDER_ADVISR
- AUDITOR
- DENTAL_TECH
- DENTIST
- BROKER
- FARMER
- OTHER
CommissionInfo:
type: object
required:
- percent
description: 'DE: Abschließende Information zur Provision.
EN: Complete information about commissions.
'
properties:
percent:
description: 'DE: Provision in Prozent.
EN: Commision in percent.
'
$ref: '#/components/schemas/Percentage'
amount:
description: 'DE: Provisionsbetrag.
EN: Provision amount.
'
$ref: '#/components/schemas/EuroAmount'
StatSourceKey:
type: string
description: 'DE: Infoquelle fuer den aktuellen Marktwert des Gebäudes oder Grundstuecks, z.B. MAP=Bodenrichtwertkarte, GSD, EVAL_COM=Gutachterausschuss, HVB, IMMOSCOUT, IMMOPOOL, LBS_LOCA=LBS_Zweigstelle, PLOETZ, IVD_SPIEGEL, BANK_LOCAL=Bank_vor_Ort, CITY, SPGNET=Sprengnetter, ING=ING_Objektbewertung, OTHER.
EN: Open ended enum contains source for the current market or land value evaluation, possible values are MAP, GSD, EVAL_COM, HVB, IMMOSCOUT, IMMOPOOL, LBS_LOCAL, PLOETZ, IVD_SPIEGEL, BANK_LOCAL, CITY, SPGNET, ING, ON_GEO, VDP_RESEARCH, OTHER.
'
example: MAP
x-extensible-enum:
- MAP
- GSD
- EVAL_COM
- EXPERT
- HVB
- IMMOSCOUT
- IMMOPOOL
- LBS_LOCAL
- PLOETZ
- IVD_SPIEGEL
- BANK_LOCAL
- CITY
- SPGNET
- ING
- OTHER
- BHW
- RDM_SPIEGEL
- ON_GEO
- VDP_RESEARCH
BuildingSavingPlanEquity:
type: object
required:
- amount
- contractNumber
description: 'DE: Details über vorhandene Bestandsbausparer Guthaben (vor der Finanzierung).
EN: details about existing building saving plan equity (before financing).
'
properties:
amount:
description: 'DE: Bausparsumme.
EN: Saving plan amount.
'
$ref: '#/components/schemas/EuroAmount'
depositValue:
$ref: '#/components/schemas/EuroAmount'
contractingDate:
description: 'DE: Vertragsbeginn.
EN: Contract start date.
'
$ref: '#/components/schemas/ISODate'
duration:
description: 'DE: Darlehensdauer/Gesamtlaufzeit.
EN: Loan duration.
'
$ref: '#/components/schemas/Duration'
allocationDate:
$ref: '#/components/schemas/ISODate'
contractNumber:
type: string
description: 'DE: Vertragsnummer.
EN: Contract number.
'
externalId:
description: id (projection id) used to identify the product used as a suspended amortization in the bank external system
type: string
FinancingDetails:
oneOf:
- $ref: '#/components/schemas/OwnEstateFinancingDetails'
- $ref: '#/components/schemas/ForeignEstateFinancingDetails'
discriminator:
propertyName: type
mapping:
OWN: '#/components/schemas/OwnEstateFinancingDetails'
FOREIGN: '#/components/schemas/ForeignEstateFinancingDetails'
OtherCapitalNeededLoan:
description: 'DE: Details über das Darlehen, welches zur Kapitalbeschaffung benötigt wird.
EN: Details about the loan needed for raising capital.
'
type: object
required:
- amount
properties:
amount:
description: 'DE: Darlehenssumme.
EN: Loan amount.
'
$ref: '#/components/schemas/EuroAmount'
usage:
$ref: '#/components/schemas/OtherCapitalNeededLoanUsage'
ApplicantRelationshipsQuery:
type: object
description: 'A wrapper Type to hold a set of possible relationships among applicants involved in the financing application.
'
properties:
data:
type: array
items:
$ref: '#/components/schemas/ApplicantRelationship'
Neighbourhood:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/NeighbourhoodKey'
MainProduct:
oneOf:
- $ref: '#/components/schemas/RegularMainProduct'
- $ref: '#/components/schemas/BridgingFinancingMainProduct'
discriminator:
propertyName: product
mapping:
ANNUITAET: '#/components/schemas/RegularMainProduct'
W_RIESTER: '#/components/schemas/RegularMainProduct'
ZWIFI: '#/components/schemas/BridgingFinancingMainProduct'
FLEX_PLUS: '#/components/schemas/RegularMainProduct'
FLEX: '#/components/schemas/RegularMainProduct'
FORWARD: '#/components/schemas/RegularMainProduct'
KOMBI: '#/components/schemas/RegularMainProduct'
KONSTANT: '#/components/schemas/RegularMainProduct'
KONST_KOMBI: '#/components/schemas/RegularMainProduct'
VERSICHER: '#/components/schemas/RegularMainProduct'
VOLLTILGER: '#/components/schemas/RegularMainProduct'
OTHER: '#/components/schemas/RegularMainProduct'
RateDetails:
oneOf:
- $ref: '#/components/schemas/AnnuityDetails'
- $ref: '#/components/schemas/SuspendedAmortizationDetails'
discriminator:
propertyName: rateType
mapping:
ANNUITY: '#/components/schemas/AnnuityDetails'
SUSPENDED_AMORTIZATION: '#/components/schemas/SuspendedAmortizationDetails'
ExistingLoanDebt:
oneOf:
- $ref: '#/components/schemas/SimpleLoanDebt'
- $ref: '#/components/schemas/SolvencyCreditDebt'
- $ref: '#/components/schemas/ExistingMortgageDebt'
- $ref: '#/components/schemas/ExistingRealEstateDebt'
discriminator:
propertyName: type
mapping:
EMPLOYMENT: '#/components/schemas/SimpleLoanDebt'
PRIVATE: '#/components/schemas/SimpleLoanDebt'
MORTGAGE_SAVING_PLAN: '#/components/schemas/SimpleLoanDebt'
OTHER: '#/components/schemas/SimpleLoanDebt'
PUBLIC: '#/components/schemas/SimpleLoanDebt'
SOLVENCY: '#/components/schemas/SolvencyCreditDebt'
EXISTING_MORTGAGE: '#/components/schemas/ExistingMortgageDebt'
EXISTING_REALESTATE: '#/components/schemas/ExistingRealEstateDebt'
OPEN_PROPERTY_SALE: '#/components/schemas/SimpleLoanDebt'
EstateRef:
type: object
required:
- estateId
description: 'DE: Id und Referenz zu der Immobilie.
EN: Id and Reference to the estate.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
estateId:
$ref: '#/components/schemas/EstateId'
ApplicantRelationships:
type: object
description: 'A wrapper Type to hold a set of possible relationships among applicants involved in the financing application.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
embedded:
$ref: '#/components/schemas/ApplicantRelationshipsQuery'
RealEstateEquityItem:
type: object
required:
- estateId
- equity
description: 'DE: Informationen zu einem bestimmten Eigenkapital durch Immobilienvermögen.
EN: Details about a specific real estate equity.
'
properties:
estateId:
$ref: '#/components/schemas/EstateId'
description:
type: string
equity:
$ref: '#/components/schemas/RealEstateEquityDetails'
guarantees:
$ref: '#/components/schemas/RealEstateGuarantees'
PropertiesRegisterInventory:
oneOf:
- $ref: '#/components/schemas/OwnershipInventory'
- $ref: '#/components/schemas/JointOwnershipInventory'
discriminator:
propertyName: type
mapping:
OWNERSHIP_INVENTORY: '#/components/schemas/OwnershipInventory'
JOINT_OWNERSHIP_INVENTORY: '#/components/schemas/JointOwnershipInventory'
CollateralMortgageProperties:
description: 'DE: Weitere Beleihungsobjekte die als Sicherheit verwendet werden.
EN: Other estates to be pledged as security deposit.
'
type: object
properties:
estates:
type: array
items:
$ref: '#/components/schemas/EstateRef'
minItems: 1
Duration:
type: object
title: Duration
description: 'DE: Gibt einen Zeitraum an. EN: Specifies a duration.
'
required:
- value
- unit
properties:
value:
type: integer
format: int32
description: 'DE: Die Menge der gewaehlten Zeiteinheit. EN: The amount of the selected temporal unit.
'
unit:
type: string
enum:
- YEARS
- MONTHS
- DAYS
description: 'DE: Die Zeiteinheit. EN: The temporal unit.
'
PlannedModernisationDetails:
oneOf:
- $ref: '#/components/schemas/PlannedHeatingModernisationDetails'
- $ref: '#/components/schemas/DefaultPlannedModernisationDetails'
discriminator:
propertyName: modernisationType
mapping:
HEATING: '#/components/schemas/PlannedHeatingModernisationDetails'
DEFAULT: '#/components/schemas/DefaultPlannedModernisationDetails'
JointOwnershipInventory:
description: 'DE: Miteigentumsanteil an einem Gründstück/Objekt.
EN: Co-ownership of a property.
'
type: object
allOf:
- $ref: '#/components/schemas/BasePropertiesRegisterInventory'
properties:
commonPropertyShare:
description: 'DE: Miteigentumsanteil (https://de.wikipedia.org/wiki/Miteigentumsanteil). EN: Co-ownership share (https://de.wikipedia.org/wiki/Miteigentumsanteil).
'
type: number
format: double
commonPropertyTotal:
description: 'DE: Summe der Miteigentumsanteile. EN: Total Co-ownership share.
'
type: number
format: double
inventoryUnitProperties:
description: 'DE: Sammlung von Sondereigentümen (https://de.wikipedia.org/wiki/Sondereigentum) die mit diesem Miteigentum verbunden sind.
EN: Collection of special properties (inventory units) associated with this co-ownership.
'
type: array
items:
$ref: '#/components/schemas/InventorySpecialProperty'
BuildingSavingPlan:
description: 'DE: Information zum Bauspardarlehen.
EN: Information about the building saving loan.
'
type: object
properties:
tariff:
$ref: '#/components/schemas/SavingPlanTariff'
amount:
description: 'DE: Bausparsumme.
EN: Saving plan amount.
'
$ref: '#/components/schemas/EuroAmount'
contractingDate:
description: 'DE: Vertragsbeginn.
EN: Contract start date.
'
$ref: '#/components/schemas/ISODate'
duration:
description: 'DE: Darlehensdauer/Gesamtlaufzeit.
EN: Loan duration.
'
$ref: '#/components/schemas/Duration'
allocationDate:
$ref: '#/components/schemas/ISODate'
savingsPhase:
$ref: '#/components/schemas/SavingsPhase'
creditPhase:
$ref: '#/components/schemas/CreditPhase'
contractSignedWith:
description: 'DE: Referenz zu den Antragsteller der den Vetrag unterschrieben hat.
EN: Reference to the applicant who signed the contract.
'
$ref: '#/components/schemas/ApplicantIdRef'
remark:
type: string
contractNumber:
type: string
readOnly: true
description: 'DE: Vertragsnummer.
EN: Contract number.
'
commission:
$ref: '#/components/schemas/CommissionInfo'
FinancialStandingRef:
type: object
description: 'A Reference to a specific FinancialStanding.
This reference consists of a link leads directly to the resource and an Id which could be used to reconstruct the url.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
financialStandingId:
$ref: '#/components/schemas/FinancialStandingId'
SavingsPlanBurdenSpecialPaymentPeriod:
type: object
required:
- from
- to
properties:
from:
$ref: '#/components/schemas/ISODate'
to:
$ref: '#/components/schemas/ISODate'
PreviousOwnerKey:
type: string
description: 'DE: Vorheriger Immobilienbesitzer (nicht abschließende Aufzählung), z.B. THIRD_PERSON, FAMILY_MEMBER.
EN: Open ended enum contains previous owner of the estate, possible values are THIRD_PERSON, FAMILY_MEMBER.
'
example: THIRD_PERSON
x-extensible-enum:
- THIRD_PERSON
- FAMILY_MEMBER
Plot:
description: 'DE: Zusätzliche Information zu der Immobilie von Typ "PLOT" (Grundstück).
EN: Additional information for the estate with the type "PLOT".
'
type: object
allOf:
- $ref: '#/components/schemas/BaseRealEstate'
properties:
rating:
$ref: '#/components/schemas/LandValueEvaluation'
marketValue:
$ref: '#/components/schemas/MarketValueEvaluation'
landSize:
description: 'DE: Grundstücksgröße.
EN: Property space.
'
$ref: '#/components/schemas/SquareMeter'
originalPurchase:
$ref: '#/components/schemas/OriginalPurchase'
FinancingVentureRenovation:
description: 'DE: Information über das Finanzierungsvorhaben beim Umbau / Modernisierung.
EN: Information about the financing venture for refurbishment / modernisation.
'
required:
- financingNeed
- financingDetails
allOf:
- $ref: '#/components/schemas/BaseFinancingVenture'
properties:
financingNeed:
$ref: '#/components/schemas/OwnEstateFinancingNeed'
financingDetails:
$ref: '#/components/schemas/FinancingDetails'
ApartmentFloorKey:
type: string
description: 'DE: Lage des Appartments im Gebäude (nicht abschließende Aufzählung), zum Beispiel: BASEMENT=Untergeschoss, GROUND_FLOOR=Erdgeschoss, UPPER_FLOOR=Obergeschoss/Erster Stock, SECOND_FLOOR=Zweiter Stock etc.
EN: open ended enum contains position of the apartment in the building, possible values are BASEMENT, GROUND_FLOOR, UPPER_FLOOR, SECOND_FLOOR, THIRD_FLOOR, FOURTH_FLOOR, FIFTH_FLOOR, SIXTH_FLOOR_OR_HIGHER
'
example: BASEMENT
x-extensible-enum:
- BASEMENT
- GROUND_FLOOR
- UPPER_FLOOR
- SECOND_FLOOR
- THIRD_FLOOR
- FOURTH_FLOOR
- FIFTH_FLOOR
- THIRD_FOURTH_OR_FIFTH_FLOOR
- SIXTH_FLOOR_OR_HIGHER
- OTHER
BaseOccupation:
type: object
required:
- type
properties:
type:
description: 'DE: Art der Erwerbstätigkeit.
EN: Type of the occupation.
'
$ref: '#/components/schemas/OccupationType'
crosser:
type: boolean
nullable: true
description: 'DE: WAHR, wenn der Antragsteller Grenzgänger ist.
EN: TRUE, if applicant is cross-border commuter.
'
mainEmployment:
type: boolean
nullable: true
description: 'DE: WAHR, wenn es sich bei der Tätigkeit um eine Hauptbeschäftigung handelt.
EN: TRUE, if occupation is main employment
'
retirementDate:
description: 'DE: Voraussichtlicher Renteneintritt.
EN: Expected retirement date.
'
$ref: '#/components/schemas/ISODate'
discriminator:
propertyName: type
ContractLimitation:
type: object
description: 'DE: Informationen ob der Vertrag befristet ist.
EN: Information about contract limitation.
'
required:
- limited
properties:
limited:
description: 'DE: Wahr, wenn der Vertrag zeitlich befristet ist.
EN: True, if the contract is temporal limited.
'
type: boolean
discriminator:
propertyName: limited
mapping:
true: '#/components/schemas/LimitedContract'
false: '#/components/schemas/UnlimitedContract'
FinancingVentureDebtRescheduling:
description: 'DE: Information über das Finanzierungsvorhaben beim Anschlussfinanzierung / Umschuldung.
EN: Information about the financing venture for follow-up financing / rescheduling.
'
required:
- financingNeed
- financingDetails
allOf:
- $ref: '#/components/schemas/BaseFinancingVenture'
properties:
financingNeed:
$ref: '#/components/schemas/OwnEstateFinancingNeed'
financingDetails:
$ref: '#/components/schemas/FinancingDetails'
InformerItem:
type: object
description: 'A wrapper Type to hold detailed information about a financing informer involved in the consultation phase.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
informerId:
$ref: '#/components/schemas/InformerId'
person:
$ref: '#/components/schemas/PersonName'
company:
type: string
description: 'DE: Firma des Zuträgers.
EN: Company of the informer.
'
embedded:
$ref: '#/components/schemas/Informer'
LoanType:
type: string
description: 'DE: Art des Darlehens (nicht abschließende Aufzählung), z.B. MAIN_LOAN, AUXILIARY_LOAN, KFW_PROMOTION_LOAN.
EN: Open ended enum contains possible loan types, possible values are MAIN_LOAN, AUXILIARY_LOAN, KFW_PROMOTION_LOAN.
'
example: MAIN_LOAN
x-extensible-enum:
- MAIN_LOAN
- AUXILIARY_LOAN
- KFW_PROMOTION_LOAN
- OTHER
RealEstateRating:
oneOf:
- $ref: '#/components/schemas/HouseRating'
- $ref: '#/components/schemas/DefaultRealEstateRating'
discriminator:
propertyName: type
mapping:
HOUSE: '#/components/schemas/HouseRating'
DEFAULT: '#/components/schemas/DefaultRealEstateRating'
ISODate:
description: 'DE: Datum, Syntax nach RFC 3339
EN: Date according to RFC 3339
'
type: string
format: date
nullable: true
example: '2019-12-29'
CalculationBaseRate:
type: object
required:
- baserateInterest
properties:
baserateInterest:
$ref: '#/components/schemas/RawPercentage'
baserateIssueDate:
description: 'DE: Einstandsdatum.
EN: Base rate issue date.
'
$ref: '#/components/schemas/ISODate'
UserId:
type: object
required:
- value
description: 'DE: ID des Users.
EN: ID of a user.
'
properties:
value:
type: string
RepaymentPlan:
type: object
properties:
loanId:
$ref: '#/components/schemas/LoanId'
planTemplate:
$ref: '#/components/schemas/PlanTemplate'
loan:
$ref: '#/components/schemas/LoanPlan'
buildingSavingPlan:
$ref: '#/components/schemas/SavingsAndRepayment'
FinancialStandingSummary:
type: object
properties:
totalIncome:
description: 'DE: Nettoeinkommen
EN: Total net income
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
totalExpenses:
description: 'DE: Ausgaben
EN: Total expenses
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
surplus:
description: 'DE: Haushaltsüberschus- Restliquidität nach Finanzierung
EN: Remaining liquidity after financing
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
reserves:
description: 'DE: Rücklagen
EN: Total reserves after financing
'
$ref: '#/components/schemas/EuroAmount'
totalLiabilities:
description: 'DE: Summe Verbindlingkeiten
EN: Total liabilities
'
$ref: '#/components/schemas/EuroAmount'
RateDetailsType:
type: string
description: 'DE: Mögliche Darlehensart (nicht abschließende Aufzählung), z.B. ANNUITY=Annuitätsdarlehen, SUSPENDED_AMORTIZATION=Tilgungsaussetzungsdarlehen.
EN: Open ended enum contains possible rates type, possible values are ANNUITY, SUSPENDED_AMORTIZATION.
example: ANNUITY
'
x-extensible-enum:
- ANNUITY
- SUSPENDED_AMORTIZATION
ModernisationScopeKey:
type: string
description: 'DE: Umfang der Modernisierung (nicht abschließende Aufzählung), z.B. (COMPLETE=komplett, PARTIAL=teilweise, UNKNOWN=unbekannt).
EN: Open ended enum contains scope of the modernisation, possible values are (COMPLETE, PARTIAL, UNKNOWN).
'
example: COMPLETE
x-extensible-enum:
- COMPLETE
- PARTIAL
- UNKNOWN
ForeignEstateFinancingNeed:
oneOf:
- $ref: '#/components/schemas/BuildEstateFinancing'
- $ref: '#/components/schemas/BuyExistingEstateFinancing'
- $ref: '#/components/schemas/BuyNewEstateFinancing'
discriminator:
propertyName: reason
mapping:
BUILD: '#/components/schemas/BuildEstateFinancing'
BUY_EXISTING: '#/components/schemas/BuyExistingEstateFinancing'
BUY_NEW: '#/components/schemas/BuyNewEstateFinancing'
PlannedModernisations:
type: object
description: 'DE: Wertsteigernde Maßnahmen bei der Modernisierung
EN: Value-enhancing renovations
'
properties:
amount:
description: 'DE: Modernisierungskosten
EN: Modernisation costs
'
$ref: '#/components/schemas/EuroAmount'
addedValue:
description: 'DE: Wert erreicht durch Modernisierungsmaßnahmen
.
EN: Added value achieved with modernisation
'
$ref: '#/components/schemas/EuroAmount'
description:
type: string
energyEfficiency:
$ref: '#/components/schemas/EnergyEfficiency'
breakdown:
description: 'DE: Detailinformation über die geplanten Modernisierungsmaßnahmen
EN: Details about planed modernisations
'
type: array
items:
$ref: '#/components/schemas/PlannedModernisation'
x-is-plural: true
LandValueEvaluation:
type: object
description: 'DE: Information über den Land Wert des Grundstücks.
EN: Information about land value evaluation.
'
required:
- groundValue
properties:
groundValue:
description: 'DE: Land Wert.
EN: Land value.
'
$ref: '#/components/schemas/EuroAmount'
evaluationInformation:
description: 'DE: Information über die Wertbewertung des Grundstücks.
EN: Information about the land value evaluation.
'
$ref: '#/components/schemas/EvaluationInformation'
BuildEstateFinancing:
description: 'DE: Finanzierungsrelevante Information zu dem Bau der Immobilie.
EN: Financing-relevant information for the construction of the property.
'
type: object
required:
- buildCosts
allOf:
- $ref: '#/components/schemas/BaseForeignEstateFinancingNeed'
properties:
buildCosts:
$ref: '#/components/schemas/EstateBuildingCosts'
completionDate:
description: 'DE: Geplante Fertigstellung.
EN: Planed completion date.
'
$ref: '#/components/schemas/ISODate'
ApplicantRelationshipTypeKey:
type: string
description: 'DE: Beziehungsart (nicht abschließende Aufzählung) z.B. (MARRIED=mit Ehepartner/in, REGISTERED_PARTNERSHIP=eingetragenem Lebenspartner/in, PARTNERSHIP=Lebenspartner/in).
EN: Open ended enum contains values for relation type, possible values are (MARRIED, REGISTERED_PARTNERSHIP, PARTNERSHIP)
'
x-extensible-enum:
- MARRIED
- REGISTERED_PARTNERSHIP
- PARTNERSHIP
- OTHER
EstateAdditionalLoanUsageKey:
type: string
description: 'DE: Zusätzliche Verwendung der Hypothek (nicht abschließende Aufzählung), z.B. OPERATIONAL_COSTS, REPAY_ANOTHER_LOAN, PREPAYMENT_PENALTY, CONSTRUCTION, RENOVATION, OTHER.
EN: Open ended enum contains possible estate additional loan usages, possible values are OPERATIONAL_COSTS, REPAY_ANOTHER_LOAN, PREPAYMENT_PENALTY, CONSTRUCTION, RENOVATION, OTHER.
'
example: OPERATIONAL_COSTS
x-extensible-enum:
- OPERATIONAL_COSTS
- REPAY_ANOTHER_LOAN
- PREPAYMENT_PENALTY
- CONSTRUCTION
- RENOVATION
- OTHER
MarketValueEvaluation:
type: object
description: 'DE: Information über eine externe Marktbewertung.
EN: Information about external market value evaluation.
'
required:
- marketValue
properties:
marketValue:
description: 'DE: Marktwert der Immobilie.
EN: Estate market value.
'
$ref: '#/components/schemas/EuroAmount'
evaluationInformation:
description: 'DE: Information über die Wertbewertung der Immobilie.
EN: Information about the estate value evaluation.
'
$ref: '#/components/schemas/EvaluationInformation'
ForwardExistingMortgage:
type: object
description: 'DE: Das Darlehen soll erst nach einer bestimmten Vorlaufzeit ausgezahlt werden.
EN: Loan shall be released.
'
properties:
date:
$ref: '#/components/schemas/ISODate'
BrokeragePlatformIdentifierKey:
type: string
description: 'DE: Interne Vermittler Quelle, wichtig für ermitteln des Vermittlernummers.
EN: Advisor company key, used to determine company identifier.
'
example: INTERHYP
x-extensible-enum:
- INTERHYP
- PROHYP
- MLP_HYP
AreaInfo:
type: object
description: 'DE: Information über die gesamte Wohn- und Nutzfläche.
EN: Information about the total residential and useable area.
'
properties:
areaRented:
description: 'DE: Vermietete Fläche.
EN: Rented space.
'
$ref: '#/components/schemas/SquareMeter'
areaTotal:
description: 'DE: Wohnfläche.
EN: Living space.
'
$ref: '#/components/schemas/SquareMeter'
landSize:
description: 'DE: Grundstücksgröße.
EN: Property space.
'
$ref: '#/components/schemas/SquareMeter'
commercialArea:
description: 'DE: Gewerbliche Fläche.
EN: Commercial space.
'
$ref: '#/components/schemas/SquareMeter'
commercialAreaForOwnUse:
description: 'DE: Gewerbliche Fläche für Eigenbedarf.
EN: Commercial space for own use.
'
$ref: '#/components/schemas/SquareMeter'
ExistingRealEstateDebt:
type: object
required:
- estate
allOf:
- $ref: '#/components/schemas/BaseExistingLoanDebt'
properties:
estate:
description: 'DE: Referenz zu dem Darlehen gehörenden Immobileie.
EN: Reference to the Estate which this Loan is associated with.
'
$ref: '#/components/schemas/EstateRef'
residualDebt:
description: 'DE: Aktuelle Restschuld.
EN: Current remaining debt.
'
$ref: '#/components/schemas/EuroAmount'
repay:
description: 'DE: Flag ob die Ablösung des Kredites vor der Finanzierung geplant ist.
EN: Flag indicates that the loan is planed to be repayed before the financing.
'
type: boolean
nullable: true
until:
$ref: '#/components/schemas/ISODate'
interestFixDate:
description: 'DE: Ablauf Sollzinsbindung.
EN: Expiry of fixed interest rate.
'
$ref: '#/components/schemas/ISODate'
description:
type: string
interestRate:
description: 'DE: Nominalzins (Sollzins)
EN: Nominal interest rate
'
$ref: '#/components/schemas/PeriodicalPercentage'
debitor:
$ref: '#/components/schemas/Debitor'
debitInterestCommitment:
$ref: '#/components/schemas/Duration'
expectedEndOfTheTerm:
$ref: '#/components/schemas/ISODate'
rankingInTheLandRegister:
type: string
SavingsPhase:
type: object
description: Sparphase
properties:
timeline:
$ref: '#/components/schemas/SavingsPlanTimeline'
savings:
$ref: '#/components/schemas/SavingsPlanBurden'
interest:
$ref: '#/components/schemas/SavingsPlanInterest'
contractFees:
$ref: '#/components/schemas/SavingsPlanFees'
accountBalanceAtAllocation:
description: 'DE: Bausparguthaben bei Zuteilung.
EN: The account balance at the moment of allocation.
'
$ref: '#/components/schemas/EuroAmount'
currentBalance:
description: 'DE: Aktuelles Bausparguthaben.
'
allOf:
- $ref: '#/components/schemas/EuroAmount'
HomePurchaseSavingProvider:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/HomePurchaseSavingProviderKey'
CreditEntry:
type: object
required:
- creditBurden
- creditInterest
- fees
- remainingCreditAmount
description: The object for a single credit entry regarding the cash flow.
properties:
creditBurden:
description: The credit rate in EUR (Darlehensrate).
$ref: '#/components/schemas/EuroAmount'
creditInterest:
description: The credit interest in EUR (Sollzinsen).
$ref: '#/components/schemas/EuroAmount'
fees:
description: The fees in EUR (Gebühren).
$ref: '#/components/schemas/EuroAmount'
remainingCreditAmount:
description: The remaining credit amount in EUR (Restschuld bei Periodenende).
$ref: '#/components/schemas/EuroAmount'
ShortTimeWork:
type: object
description: "DE: Kurzarbeit
\nEN: Short time work.\n"
properties:
shortTimeWork:
type: boolean
default: true
from:
description: 'DE: Beginndatum der Kurzarbeit
EN: Startdate of short time work
'
$ref: '#/components/schemas/ISODate'
to:
description: 'DE: Endenndatum der Kurzarbeit
EN: End date of short time work
'
$ref: '#/components/schemas/ISODate'
ModernisationType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ModernisationTypeKey'
HouseholdProductCalculation:
description: 'DE: Information zu der Haushalt Kalkulation
EN: Information about the household calculation.
'
type: object
required:
- type
- expenses
- income
- lender
- surplus
allOf:
- $ref: '#/components/schemas/BaseProductCalculation'
properties:
remainingDebtAt:
$ref: '#/components/schemas/RemainingDebtAt'
income:
$ref: '#/components/schemas/HouseholdCalculationCommandIncome'
expenses:
$ref: '#/components/schemas/HouseholdCalculationCommandExpenses'
surplus:
description: Der Haushaltsueberschuss
$ref: '#/components/schemas/PeriodicalRawEuroAmount'
lender:
type: string
description: Darlehensgeber
billType:
type: string
description: 'Household Bill Type: DEFAULT: default household bill (usually applicable at the start of the financing), RETIREMENT: household bill to be used for after retirement'
x-extensible-enum:
- RETIREMENT
- DEFAULT
StatSource:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/StatSourceKey'
EstateItem:
type: object
required:
- estateId
- type
description: 'A wrapper that holds basic information about estate.
'
properties:
ref:
description: 'DE: Id und Referenz zu der Immobilie.
EN: Id and Reference to the estate.
'
$ref: '#/components/schemas/EstateRef'
type:
description: 'DE: Immobilientyp.
EN: Type of the estate.
'
$ref: '#/components/schemas/PropertyType'
embedded:
description: 'DE: Vollständige Daten zu der Immobilie.
EN: Complete data about the estate.
'
$ref: '#/components/schemas/Estate'
InventorySpecialProperty:
type: object
properties:
number:
description: 'DE: Nummer des Sondereigentums (z. B. Wohnungsnummer).
EN: Number of the special property (e.g. apartment number).
'
type: string
type:
$ref: '#/components/schemas/SpecialPropertyType'
JobProbation:
type: object
required:
- probationPeriodEndDate
properties:
probationPeriodEndDate:
$ref: '#/components/schemas/ISODate'
ApplicationSubType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ApplicationSubTypeKey'
SavingsPlanTimeline:
type: object
properties:
startDate:
description: 'DE: Sparbeginn.
EN: Saving start date.
'
$ref: '#/components/schemas/ISODate'
endDate:
description: 'DE: Datum letzter Sparbeitrag.
EN: The end date of the savings phase.
'
$ref: '#/components/schemas/ISODate'
duration:
description: 'DE: Voraussichtliche Anspardauer.
EN: Expected saving duration.
'
$ref: '#/components/schemas/Duration'
ParcelAndDistrict:
description: 'DE: Information über Gemarktung und Flurstück.
EN: Information about the cadastral district and the land parcel.
'
required:
- parcel
properties:
district:
description: 'DE: Gemarkung/Bezirk.
EN: Cadastral district.
'
type: string
corridor:
description: 'DE: Flur.
EN: Corridor.
'
type: string
parcel:
description: 'DE: Flurstück.
EN: Land parcel.
'
type: string
SolvencyCreditDebt:
type: object
description: 'DE: Raten- und Leasingkredite.
EN: Installment and leasing credits.
'
allOf:
- $ref: '#/components/schemas/BaseExistingLoanDebt'
properties:
liabilityType:
$ref: '#/components/schemas/Liability'
contractNumber:
type: string
residualDebt:
description: 'DE: Aktuelle Restschuld.
EN: Current remaining debt.
'
$ref: '#/components/schemas/EuroAmount'
repay:
description: 'DE: Flag ob die Ablösung des Kredites vor der Finanzierung geplant ist.
EN: Flag indicates that the loan is planed to be repayed before the financing.
'
type: boolean
nullable: true
until:
description: 'DE: Ablauf der Sollzinsbindung.
EN: Expiry of the fixed interest rate.
'
$ref: '#/components/schemas/ISODate'
burden:
description: 'DE: Periodische Rate (z.B. monatliche Rate).
EN: Periodical payment amount (e.g. rate per month).
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
debitor:
$ref: '#/components/schemas/Debitor'
LoanToValueRatioLendingBreakdown:
title: LoanToValueRatioLendingBreakdown
type: object
required:
- valuation
- entries
properties:
valuation:
description: Die Summe der Gesamtwerte, die die Bank ansetzt in Euro
$ref: '#/components/schemas/RawEuroAmount'
entries:
type: array
items:
$ref: '#/components/schemas/LoanToValueRatioEntry'
BuyExistingEstateFinancing:
description: 'DE: Finanzierungsrelevante Information zu dem Kauf bestehender Immobilie.
EN: Financing-relevant information for the purchase of an existing property.
'
type: object
required:
- purchasePrice
allOf:
- $ref: '#/components/schemas/BaseForeignEstateFinancingNeed'
properties:
renovationCosts:
description: 'DE: Summe der durchgeführten wertsteigernden Maßnahmen bei der Renovierung.
EN: Sum of completed value-enhancing refurbishments.
'
$ref: '#/components/schemas/EuroAmount'
plannedModernisations:
$ref: '#/components/schemas/PlannedModernisations'
purchasePrice:
description: 'DE: Kaufpreis der Immobilie.
EN: Purchase price of the property.
'
$ref: '#/components/schemas/EuroAmount'
priceDue:
description: 'DE: Fälligkeit des Kaufpreises.
EN: Due date of the purchase price.
'
$ref: '#/components/schemas/ISODate'
notaryDate:
description: 'DE: Notartermin.
EN: Notary date.
'
$ref: '#/components/schemas/ISODate'
FinancialStandings:
type: object
description: 'Wrapper Type holds set of Financial Standings.
'
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/FinancialStandingItem'
summary:
$ref: '#/components/schemas/FinancialStandingSummary'
RegularPayment:
description: 'DE: Information über den regulären Zahlungen.
EN: Information about regular payment.
'
type: object
properties:
paymentTime:
$ref: '#/components/schemas/PaymentTime'
freePeriod:
description: 'DE: Tilgungsfreie Anlaufzeit.
EN: Amortisation-free period.
'
$ref: '#/components/schemas/Duration'
amount:
description: 'DE: Rate in der tilgungsfreien Anlaufzeit.
EN: Amortisation during amortisation-free period.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
amountAfterFreePeriod:
description: 'DE: Rate nach Ablauf der tilgungsfreien Anlaufzeit.
EN: Rate after amortisation-free period.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
ParkingSpace:
type: object
required:
- type
description: 'DE: Information über den Parkplatz.
EN: Information about the parking space.
'
properties:
type:
$ref: '#/components/schemas/ParkingSpaceType'
pitchNumber:
description: 'DE: Stellplatznummer.
EN: Parking Space Number.
'
type: string
count:
description: 'DE: Anzahl Parkplätze von diesem Typ.
EN: Number of parking spaces of this type.
'
type: integer
format: int32
MainLoanAdditionalInfo:
type: object
description: 'DE: Zustzäliche Information zum Hauptdarlehen.
EN: Additional informations for main loan.
'
properties:
conditionDetails:
type: array
description: 'DE: Zusätzliche Konditionsdetails für das Hauptdarlehen (Schlüssel-Werte Paar).
EN: Additional condition details for the main loan (key-value pairs).
'
items:
$ref: '#/components/schemas/AdditionalInfo'
provisionDetails:
type: array
description: 'DE: Zusätzliche Provisionsdetails für das Hauptdarlehen (Schlüssel-Werte Paar).
EN: Additional commission (provision) details for the main loan (key-value pairs).
'
items:
$ref: '#/components/schemas/AdditionalInfo'
LoanConditionInterest:
description: 'DE: Zusammenfassung von Informationen zu einzelnem Darlehen (Konditionskalkulation).
EN: Summary information about single loan (conditions calculation).
'
type: object
required:
- effectiveRate
- nominalRate
properties:
effectiveRate:
description: 'DE: Effektiver Zins.
EN: Effective interest rate.
'
$ref: '#/components/schemas/PeriodicalRawPercentage'
nominalRate:
description: 'DE: Sollzins
EN: Nominal rate.
'
$ref: '#/components/schemas/PeriodicalRawPercentage'
CreditPhaseTimeline:
type: object
properties:
amortisationStartDate:
description: 'DE: Tilgungsbeginn.
EN: The date on which the amortisation starts.
'
$ref: '#/components/schemas/ISODate'
amortisationEndDate:
description: 'DE: Tilgungsende.
EN: The date on which the amortisation end.
'
$ref: '#/components/schemas/ISODate'
duration:
description: 'DE: Voraussichtliche Kreditsdaur.
EN: credit phase duration.
'
$ref: '#/components/schemas/Duration'
Estate:
oneOf:
- $ref: '#/components/schemas/Apartment'
- $ref: '#/components/schemas/House'
- $ref: '#/components/schemas/Plot'
discriminator:
propertyName: type
mapping:
APARTMENT: '#/components/schemas/Apartment'
DETACHED_HOUSE: '#/components/schemas/House'
SEMI_DETACHED_HOUSE: '#/components/schemas/House'
TWO_FAMILY_HOUSE: '#/components/schemas/House'
END_TERRACE_HOUSE: '#/components/schemas/House'
MID_TERRACE_HOUSE: '#/components/schemas/House'
APARTMENT_BUILDING: '#/components/schemas/House'
RESIDENTIAL_AND_COMMERCIAL_BUILDING: '#/components/schemas/House'
PROPERTY: '#/components/schemas/Plot'
COMMERCIAL_PROPERTY: '#/components/schemas/Plot'
ConstructionCostInvoiceKey:
type: string
description: 'DE: Die Instanz, mit welcher die Abrechnung der Baukosten erfolgt. PROPERTY_DEVELOPER = Bautraeger, GENERAL_CONTRACTOR = Generalunternehmer, ARCHITECT = Architekt, INDIVIDUAL_TRADES = Einzelgewerkvergabe
EN: Open ended enum contains the instance to which the construction costs are charged.
'
example: MAP
x-extensible-enum:
- PROPERTY_DEVELOPER
- GENERAL_CONTRACTOR
- ARCHITECT
- INDIVIDUAL_TRADES
- UNKNOWN
BaseSpecialRepayment:
type: object
required:
- type
description: 'DE: Information zur Sondertilgung.
EN: Special repayment information.
'
properties:
type:
$ref: '#/components/schemas/SpecialRepaymentType'
discriminator:
propertyName: type
RemainingDebtAt:
type: object
required:
- date
- components
properties:
date:
$ref: '#/components/schemas/ISODate'
components:
type: array
items:
$ref: '#/components/schemas/RemainingDebtAtComponent'
SavingsPlanBurdenSpecialPayment:
type: object
required:
- period
- amount
properties:
period:
$ref: '#/components/schemas/SavingsPlanBurdenSpecialPaymentPeriod'
amount:
$ref: '#/components/schemas/EuroAmount'
frequency:
description: 'DE: Häufigkeit der Zahlungen.
EN: Frequency of payments
'
$ref: '#/components/schemas/Cycle'
EuroAmount:
description: 'DE: Euro Betrag as double.
EN: Euro amount as double
'
type: object
required:
- value
properties:
value:
description: 'DE: Betrag.
EN: Value.
'
type: number
format: double
ExtendedPeriodicalCreditEntry:
type: object
description: The credit entries including markings for special entries.
allOf:
- $ref: '#/components/schemas/PeriodicalCreditEntry'
properties:
markings:
type: array
items:
$ref: '#/components/schemas/EntryMarking'
RealEstate:
description: 'DE: Allgemeine Information zu der Immobilie.
EN: General information about the estate.
'
type: object
allOf:
- $ref: '#/components/schemas/BaseRealEstate'
properties:
originalPurchase:
$ref: '#/components/schemas/OriginalPurchase'
building:
$ref: '#/components/schemas/Building'
condition:
$ref: '#/components/schemas/RealEstatePropertyCondition'
furnishing:
$ref: '#/components/schemas/Furnishing'
parkingSpaces:
description: 'DE: Stellplätze und Garagen der Immobilie.
EN: Parking spaces and garages of the property.
'
type: array
items:
$ref: '#/components/schemas/ParkingSpace'
existingModernisations:
$ref: '#/components/schemas/ExistingModernisations'
area:
$ref: '#/components/schemas/AreaInfo'
utilization:
$ref: '#/components/schemas/Utilization'
rent:
$ref: '#/components/schemas/RentInfo'
numberOfRooms:
description: 'DE: Anzahl der Zimmer für die angegebene Wohnung EN: Number of rooms for declared apartment
'
type: number
format: float
OrganizationCompany:
type: object
properties:
companyId:
$ref: '#/components/schemas/CompanyId'
companyName:
$ref: '#/components/schemas/CompanyName'
companyAddress:
$ref: '#/components/schemas/Address'
companyContact:
$ref: '#/components/schemas/Contact'
regulatoryAuthority:
$ref: '#/components/schemas/RegulatoryAuthority'
BuyNewEstateFinancing:
type: object
description: 'DE: Finanzierungsrelevante Information zum Kauf der Neubauimmobilie.
EN: Financing-relevant information for the purchase of a newly built property.
'
required:
- purchasePrice
allOf:
- $ref: '#/components/schemas/BaseForeignEstateFinancingNeed'
properties:
optionalEquipment:
description: 'DE: Kosten für Sonderausstattungen.
EN: Special / optional equipment costs.
'
$ref: '#/components/schemas/EuroAmount'
purchasePrice:
description: 'DE: Kaufpreis des Objekts.
EN: Purchase price.
'
$ref: '#/components/schemas/EuroAmount'
priceDue:
description: 'DE: Fälligkeit des Kaufpreises.
EN: Due date of the purchase price.
'
$ref: '#/components/schemas/ISODate'
notaryDate:
description: 'DE: Notartermin.
EN: Notary date.
'
$ref: '#/components/schemas/ISODate'
TextSpecialRepayment:
description: 'DE: Sondertilgung in Textform.
EN: Special repayment presented as text.
'
type: object
required:
- text
allOf:
- $ref: '#/components/schemas/BaseSpecialRepayment'
properties:
text:
description: 'DE: Sondertilgung in Textform.
EN: Special repayment in text format.
'
type: string
FreeLancerJobType:
type: object
description: 'DE: Art der freiberuflichen Tätigkeit.
EN: Freelancer job type.
'
required:
- key
properties:
key:
$ref: '#/components/schemas/FreeLancerJobTypeKey'
BaseRealEstate:
type: object
required:
- id
- type
properties:
id:
$ref: '#/components/schemas/EstateId'
type:
$ref: '#/components/schemas/PropertyType'
address:
description: 'DE: Adresse der Immobilie.
EN: Estate address.
'
$ref: '#/components/schemas/Address'
propertyRegister:
$ref: '#/components/schemas/PropertyRegister'
liabilities:
type: array
items:
$ref: '#/components/schemas/PropertyRegister'
location:
$ref: '#/components/schemas/PropertyLocation'
leaseInfo:
$ref: '#/components/schemas/LeaseInfo'
existingMortgages:
type: array
description: 'DE: Sammlung von Referenzen zu dem existierenden Hypotheken.
EN: Reference collection to the existing mortgages associated with this estate.
'
items:
$ref: '#/components/schemas/ExistingMortgageRef'
description:
description: 'DE: Immobilienbeschreibung.
EN: Estate description.
'
type: string
externalEstateId:
$ref: '#/components/schemas/ExternalEstateId'
discriminator:
propertyName: type
OwnEstateFinancingNeed:
oneOf:
- $ref: '#/components/schemas/DebtReschedulingFinancing'
- $ref: '#/components/schemas/OtherCapitalFinancing'
- $ref: '#/components/schemas/RenovateEstateFinancing'
discriminator:
propertyName: reason
mapping:
DEBT_RESCHEDULING: '#/components/schemas/DebtReschedulingFinancing'
OTHER_CAPITAL: '#/components/schemas/OtherCapitalFinancing'
RENOVATE: '#/components/schemas/RenovateEstateFinancing'
DefaultUnionInfo:
allOf:
- $ref: '#/components/schemas/BaseUnionInfo'
SavingsPlanInterest:
type: object
properties:
interestRate:
description: 'DE: Guthabenzinssatz.
EN: interest rate.
'
$ref: '#/components/schemas/PeriodicalPercentage'
interestAccumulated:
description: 'DE: Guthabenzinsen insgesamt.
EN: The savings interest accumulated.
'
$ref: '#/components/schemas/EuroAmount'
HomePurchaseSavingProviderKey:
type: string
example: OTHER
description: Home purchase saving plan provider (BHWDISPO - BHW, DEUTDEFF - Deutsche Bank, ALTEDEFA - Alte Leipziger, LBS - LBS, BSWLDE - Wüstenrot, STARTBS - start:bausparkasse)
x-extensible-enum:
- BHWDISPO
- ALTEDEFA
- DEUTDEFF
- LBS
- BSWLDE
- STARTBS
- OTHER
KfwCallType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/KfwCallTypeKey'
SavingsPlanFees:
type: object
properties:
accountFee:
description: 'DE: Kontoführungsgebühr.
EN: Account maintenance fee.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
closingFee:
description: 'DE: Abschlussgebühr für das Produkt.
EN: Acquisition fee for the product.
'
$ref: '#/components/schemas/EuroAmount'
payedFees:
description: 'DE: Gebühren insgesamt.
EN: The sum of all the fees payed in the savings phase.
'
$ref: '#/components/schemas/EuroAmount'
MarkingName:
type: string
x-extensible-enum:
- FIXED_INTEREST_RATE_END
- AMORTIZATION_RATE_CHANGED
- EXTRA_PAYMENT
- AGIO
Debitor:
type: object
description: 'DE: Darlehensgeber.
EN: Information about loan debitor.
'
properties:
bic:
description: 'DE: BIC-Code des Darlehensgebers.
EN: BIC code of loaner.
'
$ref: '#/components/schemas/Bic'
name:
description: 'DE: Schuldner.
EN: Debitor.
'
type: string
Income:
type: object
required:
- type
description: 'DE: Ein Untertyp von "Financial Standing", welcher alle Informationen zu den `Einkünften` beinhaltet.
EN: A specific financial standing type holds all information related to periodical `Income` aspects.
'
allOf:
- $ref: '#/components/schemas/BaseFinancialStanding'
properties:
regularEmployment:
$ref: '#/components/schemas/RegularEmploymentIncome'
selfEmployment:
$ref: '#/components/schemas/SelfEmploymentIncome'
auxiliary:
$ref: '#/components/schemas/AuxiliaryIncome'
family:
$ref: '#/components/schemas/FamilyIncome'
pension:
description: 'DE: Zusätzliches regelmäßiges Einkommen aus Rente/Pension.
EN: Additional periodical income from pension.
'
$ref: '#/components/schemas/PensionIncome'
pensionEntitlement:
description: 'DE: Rentenansprüche.
EN: Pension entitlement.
'
$ref: '#/components/schemas/PensionIncome'
capital:
$ref: '#/components/schemas/CapitalIncome'
other:
$ref: '#/components/schemas/OtherIncome'
RegularEmploymentIncome:
type: object
description: 'DE: Informationen über ein regelmäßiges Einkommen aus einem Beschaeftigungsverhaeltnis.
EN: Information about regular employment income.
'
properties:
salary:
$ref: '#/components/schemas/Salary'
variable:
$ref: '#/components/schemas/VariableIncome'
grossIncomePreviousYear:
description: 'DE: Bruttoeinkommen des Vorjahres.
EN: Gross income of the previous year.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
taxableIncomePastYears:
description: 'DE: Zu versteuerndes Einkommen vergangener Jahre.
EN: Taxable income of previous years.
'
type: array
items:
$ref: '#/components/schemas/TaxableIncome'
Percentage:
description: 'DE: Prozentsatz als double.
EN: Percentage as double.
'
type: object
required:
- value
properties:
value:
description: 'DE: Prozentsatz.
EN: Percentage.
'
type: number
format: double
Bic:
type: object
description: 'DE: BIC
EN: The Business Identifier Code
'
required:
- value
properties:
value:
type: string
example: INGBDEFF
pattern: ^[A-Z]{6}[2-9A-Z]{1}[0-9A-Z]{1}([0-9A-Z]{3})?$
BuildingSavingsPlan:
type: object
description: Savings plan (Sparplan, Summe Sparplan, letzte Periode Sparplan) including marking for special entries.
required:
- entries
- entriesAggregated
properties:
entries:
description: The array of savings entries (Sparplan).
items:
$ref: '#/components/schemas/ExtendedPeriodicalSavingsEntry'
type: array
entriesAggregated:
$ref: '#/components/schemas/SavingsEntry'
VariableInterestMaturity:
description: 'DE: Information über die variable Sollzinsbindung.
EN: Information about variable interest rate maturity.
'
type: object
required:
- type
allOf:
- $ref: '#/components/schemas/BaseInterestMaturity'
PrefabricationKey:
type: string
description: 'DE: Besonderheiten der Bauart (nicht abschließende Aufzählung), z.B NO_SPECIFICS=keine_Besonderheiten, PREFABRICATED_Fertighaus, BAREBONES_HOUSE_Ausbauhaus, CONSTRUCTION_KIT_Bausatzhaus .
EN: Open ended enum contains special construction design, possible values are NO_SPECIFICS, PREFABRICATED_HOUSE, GROW_HOUSE, SELF_BUILD_HOUSE .
'
example: NO_SPECIFICS
x-extensible-enum:
- NO_SPECIFICS
- PREFABRICATED_HOUSE
- GROW_HOUSE
- SELF_BUILD_HOUSE
- OTHER
MainProductType:
type: string
description: 'DE: Produkttyp des Darlehens (nicht abschließende Aufzählung), z.B. (ANNUITAET=Annuitätendarlehen, W_RIESTER=Wohnriesterdarlehen, ZWIFI=Zwischenfinanzierung, FLEX_PLUS, FLEX, FORWARD, KOMBI, KONSTANT, KONST_KOMBI, VERSICHER, VOLLTILGER, OTHER) EN: open ended enum contains loan product type, possible values are (ANNUITAET, W_RIESTER, ZWIFI, FLEX_PLUS, FLEX, FORWARD, KOMBI, KONSTANT, KONST_KOMBI, VERSICHER, VOLLTILGER, OTHER)
'
example: ANNUITAET
x-extensible-enum:
- ANNUITAET
- W_RIESTER
- ZWIFI
- FLEX_PLUS
- FLEX
- FORWARD
- KOMBI
- KONSTANT
- KONST_KOMBI
- VERSICHER
- VOLLTILGER
- OTHER
AtticDetailKey:
type: string
description: 'DE: Details zum Dachgeschoss (nicht abschließende Aufzählung), z.B DEVELOPED=ausgebaut, UPGRADEABLE=ausbaufähig, NOT_UPGRADEABLE=nicht_ausbaufähig.
EN: open ended enum contains attic details, possible values are DEVELOPED, UPGRADEABLE, NOT_UPGRADEABLE.
'
example: DEVELOPED
x-extensible-enum:
- DEVELOPED
- PARTIALLY_DEVELOPED
- UPGRADEABLE
- NOT_UPGRADEABLE
- OTHER
LoanPartnerProcessingUnitName:
description: 'DE: Bezeichnung / Name der Einheit des Kreditgebers, welche den Kreditantrag bearbeitet.
EN: Name of the loan partner processing unit.
'
type: object
properties:
value:
type: string
SuspendedAmortizationCombinedProduct:
oneOf:
- $ref: '#/components/schemas/SuspendedAmortizationOtherProduct'
- $ref: '#/components/schemas/SuspendedAmortizationBuildingSavingProduct'
discriminator:
propertyName: product
mapping:
OTHER: '#/components/schemas/SuspendedAmortizationOtherProduct'
DT_KAP_LV: '#/components/schemas/SuspendedAmortizationOtherProduct'
DT_KAP_RV: '#/components/schemas/SuspendedAmortizationOtherProduct'
BRIT_KAP_LV: '#/components/schemas/SuspendedAmortizationOtherProduct'
BRIT_KAP_RV: '#/components/schemas/SuspendedAmortizationOtherProduct'
FONDS_LV: '#/components/schemas/SuspendedAmortizationOtherProduct'
FONDS_RV: '#/components/schemas/SuspendedAmortizationOtherProduct'
FONDS_SPAR: '#/components/schemas/SuspendedAmortizationOtherProduct'
BAU_SPAR: '#/components/schemas/SuspendedAmortizationBuildingSavingProduct'
CubicMeter:
type: object
description: 'DE: Angabe in Kubikmetern.
EN: Specification in cubic metres.
'
required:
- value
properties:
value:
type: number
format: double
Prefabrication:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PrefabricationKey'
PeriodicalRepaymentEntry:
type: object
allOf:
- $ref: '#/components/schemas/EntryPeriod'
required:
- creditBurden
- creditInterest
- creditRepayment
- remainingCreditAmount
properties:
creditInterest:
description: The interest payed in this period (Sollzins)
$ref: '#/components/schemas/EuroAmount'
creditRepayment:
description: The repayment payed in this period (Tilgungsrate)
$ref: '#/components/schemas/EuroAmount'
creditBurden:
description: The credit burden in this period (Darlehensrate)
$ref: '#/components/schemas/EuroAmount'
remainingCreditAmount:
description: The current credit amount (Darlehensstand)
$ref: '#/components/schemas/EuroAmount'
repaymentTotal:
description: The total repayments payed until (and including) the current period
$ref: '#/components/schemas/EuroAmount'
interestTotal:
description: The total interest payed until (and including) the current period
$ref: '#/components/schemas/EuroAmount'
burdenTotal:
description: The total payments payed until (and including) the current period
$ref: '#/components/schemas/EuroAmount'
markings:
type: array
items:
$ref: '#/components/schemas/EntryMarking'
Inhabitants:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/InhabitantsKey'
ParentalLeave:
type: object
description: "DE: Beschreibt ein (Angestelltes) Beschäftigungsverhältnis das wegen Elternzeit aktuell ruht
\nEN: Describes an employment that is currently paused due to parental leave.\n"
required:
- parentalLeaveStartDate
- parentalLeaveEndDate
properties:
parentalLeaveStartDate:
description: 'DE: Datum des Anfangs der Elternzeit
EN: Startdate of parental leave
'
$ref: '#/components/schemas/ISODate'
parentalLeaveEndDate:
description: 'DE: Ende der Elternzeit
EN: End date of parental leave
'
$ref: '#/components/schemas/ISODate'
VentureRelevantLoanTypeKey:
type: string
description: 'DE: Bestehender Darlehenstyp (nicht abschließende Aufzählung), z.B. EMPLOYMENT=Arbeitgeberdarlehen, PRIVATE=Privatdarlehen, MORTGAGE_SAVING_PLAN=Bauspardarlehen, PUBLIC=Öffentliche Darlehen, OTHER=Sonstige Darlehen.
EN: Open ended enum contains existing loan debt type, possible values are (EMPLOYMENT, PRIVATE, MORTGAGE_SAVING_PLAN, PUBLIC, OTHER)
'
example: EMPLOYMENT
x-extensible-enum:
- EMPLOYMENT
- PRIVATE
- MORTGAGE_SAVING_PLAN
- PUBLIC
- OTHER
AlimonyExpenseDetail:
type: object
required:
- alimonyType
- amount
properties:
alimonyType:
type: string
description: 'DE: Typ des Unterhalts
EN: Type of alimony
'
x-extensible-enum:
- CHILD_ALIMONY
- MARITAL_ALIMONY
- FAMILY_ALIMONY
- SEPARATION_ALIMONY
amount:
description: 'DE: Unterhaltsausgabe.
EN: Alimony expense
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
endDate:
description: 'DE: ein Enddatum für die Unterhaltszahlunge
EN: an end date for the alimony payment.
'
$ref: '#/components/schemas/ISODate'
SavingsAndRepayment:
type: object
description: Defines the savings and the repayment plan for a building savings plan (Bausparer Spar und Tilgungsplan)
required:
- savingsPlan
- repaymentPlan
properties:
savingsPlan:
$ref: '#/components/schemas/BuildingSavingsPlan'
repaymentPlan:
$ref: '#/components/schemas/BuildingRepaymentPlan'
LoanPartnerProcessingUnit:
type: object
description: 'DE: Informationen zur Einheit des Kreditgebers, welche den Kreditantrag bearbeitet.
EN: Information about the processing unit of the financing partner.
'
required:
- id
deprecated: true
properties:
id:
$ref: '#/components/schemas/LoanPartnerProcessingUnitId'
name:
$ref: '#/components/schemas/LoanPartnerProcessingUnitName'
parentUnit:
description: 'DE: Zeigt die übergeordnete Orginazitioneinheit von der für den Kreditantrag zuständigen Einheit an.
> z.B. Hauptsitz und Filiale einer Bank.
EN: Information about the processing unit hierarchy by establishing a reference to the parent processing unit.
> i.e. Branch as a processing unit can have Bank as a parent processing unit, etc ...
'
$ref: '#/components/schemas/LoanPartnerProcessingUnit'
DefaultPlannedModernisationDetails:
allOf:
- $ref: '#/components/schemas/BasePlannedModernisationDetails'
Loan:
oneOf:
- $ref: '#/components/schemas/MainLoan'
- $ref: '#/components/schemas/KfwPromotionLoan'
- $ref: '#/components/schemas/AuxiliaryLoan'
discriminator:
propertyName: type
mapping:
MAIN_LOAN: '#/components/schemas/MainLoan'
KFW_PROMOTION_LOAN: '#/components/schemas/KfwPromotionLoan'
AUXILIARY_LOAN: '#/components/schemas/AuxiliaryLoan'
LoanQuotaType:
description: 'DE: Wrapper für Ursprung des Wertes der Darlehensquote
EN: Wrapper for loan quota value types.
'
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/LoanQuotaTypeKey'
FinancingOffer:
description: 'DE: Information über das Finanzierungsangebot.
EN: Information about the financing offer (bid).
'
type: object
required:
- id
- status
properties:
id:
$ref: '#/components/schemas/OfferId'
financingConfirmationRequired:
description: 'DE: Gibt an, ob eine Finanzierungsbestätigung benötigt wird.
EN: Indicates if financing confirmation should be provided
'
type: boolean
nullable: true
status:
$ref: '#/components/schemas/FinancingOfferStatus'
loanQuota:
$ref: '#/components/schemas/LoanQuota'
financingNeed:
$ref: '#/components/schemas/OfferFinancingNeed'
financingStructures:
$ref: '#/components/schemas/FinancingStructures'
validity:
description: 'DE: Ablaufdatum des Angebots.
EN: Offer expiration date.
'
$ref: '#/components/schemas/ISODateTime'
baserateIssueDate:
description: 'DE: Einstandsdatum.
EN: Base rate issue date.
'
$ref: '#/components/schemas/ISODate'
offerDate:
description: 'DE: Angebotsdatum.
EN: Offer creation date.
'
$ref: '#/components/schemas/ISODate'
additionalInfos:
description: 'DE: Zusätzliche Details für das Angebot (Schlüssel-Werte Paar).
EN: Additional offer details (key-value pairs).
'
type: array
items:
$ref: '#/components/schemas/AdditionalInfo'
AdditionalApplicants:
description: 'DE: Nebenantragssteller für das Finanzierungsvorhaben.
EN: Additional applicants for the financing venture.
'
type: object
properties:
applicants:
type: array
items:
$ref: '#/components/schemas/ApplicantIdRef'
minItems: 0
Executive:
type: object
allOf:
- $ref: '#/components/schemas/BaseOccupation'
properties:
jobInformation:
$ref: '#/components/schemas/JobInformation'
contractLimitation:
$ref: '#/components/schemas/ContractLimitation'
shareHolding:
$ref: '#/components/schemas/ShareHolding'
parentalLeave:
$ref: '#/components/schemas/ParentalLeave'
SubmissionItem:
type: object
description: 'Holds basic information identifying a specific submission resource.
'
required:
- submissionRef
- submittedAt
properties:
submissionRef:
$ref: '#/components/schemas/SubmissionRef'
submittedAt:
description: 'DE: Datum der Einreichung.
EN: Date when this submission has been submitted.
'
$ref: '#/components/schemas/ISODateTime'
BasePlannedModernisationDetails:
type: object
required:
- modernisationType
properties:
modernisationType:
type: string
discriminator:
propertyName: modernisationType
EstateId:
type: object
required:
- value
description: 'DE: ID der Immobilie.
EN: ID of the estate.
'
properties:
value:
type: string
FinancingOfferItem:
type: object
description: 'DE: Referenz zum Finanzierungsangebot.
EN: Reference to the financing offer.
'
required:
- _href
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
embedded:
description: 'DE: Komplette Information über das Finanzierungsangebot.
EN: Complete information about the financing offer.
'
$ref: '#/components/schemas/FinancingOffer'
LiabilityKey:
type: string
example: SMALL_LOAN
description: "DE: Art des Kredits (\n CONSUMER_CREDIT=Konsumentenkredit,\n CAR_CREDIT=Autokredit,\n LINE_OF_CREDIT=Rahmenkredit,\n CALL_CREDIT=Abrufkredit,\n BUSINESS_CREDIT=Geschäftskredit,\n CREDIT_CARD=Kreditkarte,\n EMPLOYEE_LOAN=Arbeitgeberdarlehen\n ZERO_PERCENT_FINANCING=0%-Finanzierung,\n BALLOON_FINANCING=Ballonfinanzierung,\n BLANK_MORTGAGE=Blanko-Bauspardarlehen,\n EDUCATION_LOAN=Bildungskredit,\n SUBSTITUTE_SECURITY=Ersatzsicherheit,\n SMALL_LOAN=Kleindarlehen,\n LEASING_PRIVATE=Leasingprivat,\n LEASING_BUSINESS=Leasinggeschäft)
\nEN: type of liability\n"
x-extensible-enum:
- CONSUMER_CREDIT
- CAR_CREDIT
- LINE_OF_CREDIT
- CALL_CREDIT
- BUSINESS_CREDIT
- CREDIT_CARD
- EMPLOYEE_LOAN
- ZERO_PERCENT_FINANCING
- BALLOON_FINANCING
- BLANK_MORTGAGE
- EDUCATION_LOAN
- SUBSTITUTE_SECURITY
- SMALL_LOAN
- LEASING_PRIVATE
- LEASING_BUSINESS
ResidualDebtProtections:
type: object
description: 'A wrapper Type to hold a set of submission residual debt protections.
'
properties:
data:
type: array
items:
$ref: '#/components/schemas/ResidualDebtProtection'
InterestMaturityType:
type: string
description: 'DE: Art der Sollzinsbindung(nicht abschließende Aufzählung), z.B. FIXED_PERIOD, VARIABLE.
EN: Open ended enum contains types of the interest maturity, possible values are FIXED_PERIOD, VARIABLE.
'
example: FIXED_PERIOD
x-extensible-enum:
- FIXED_PERIOD
- VARIABLE
- OTHER
OtherEquity:
type: object
description: 'DE: Sonstiges Vermögen (vor der Finanzierung).
EN: Other assets (before financing).
'
properties:
amount:
$ref: '#/components/schemas/EuroAmount'
description:
type: string
OfferFinancingNeedCost:
description: 'DE: Kosten verbunden mit der gewünschten Finanzierung.
EN: Costs associated with the wanted financing.
'
type: object
properties:
mortgageProperty:
description: 'DE: Gesamtkosten Finanzierungsobjekt.
EN: Total costs associated with lending object.
'
$ref: '#/components/schemas/EuroAmount'
acquisition:
description: 'DE: Gesamtkosten relevant zum Erwerb einer Immobilie.
EN: Total costs associated with acquisition of a property.
'
$ref: '#/components/schemas/EuroAmount'
DebtReschedulingFinancing:
description: 'DE: Finanzierungsrelevante Information zur Anschlussfinanzierung / Umschuldung.
EN: Financing-relevant information for the follow-up financing / rescheduling.
'
type: object
allOf:
- $ref: '#/components/schemas/BaseOwnEstateFinancingNeed'
properties:
additionalLoan:
$ref: '#/components/schemas/EstateAdditionalLoan'
UnionInfoDBB:
type: object
description: 'DE: Informationen zum Deutschen Beamten Bund EN: Information regarding German Civil Service Federation
'
allOf:
- $ref: '#/components/schemas/BaseUnionInfo'
required:
- singleUnion
properties:
singleUnion:
type: string
description: 'DE: Einzelgewerkschaft (nur wenn organisation = DBB)
EN: single union (only when organisation = DBB)
'
x-extensible-enum:
- BBB
- BBW
- BDZ
- BBH
- BTE
- BSBD
- BDF
- BDR
- BVOGD
- BLBS
- VLW
- BVLB
- DBB_BE
- DBB_BB
- DBB_HB
- DBB_HE
- DBB_MV
- DBB_RP
- DBB_SH
- DBB_SL
- DBB_ST
- DBB_F
- DBB_S
- DBB_HH
- DBB_J
- DBB_NW
- DJG
- DPOLG
- DSTG
- DVG
- DAAV
- DBSH
- DGVB
- DPHV
- DRB
- VDSTR
- FKA_NW
- FLK_NW
- FG_BW
- FWSV
- GE_NI
- GDS
- GDV
- GDL
- GKL_BE
- BTB
- KEG
- KOMBA
- DBVKOM
- LBB
- MA_DBB
- NBB
- SBB
- TBB
- VDB
- VDL
- VBE
- VAB
- VBB
- VBOB
- VBRG
- VDR
- VHW
- VRB
- VBBA
- VRFF
- OTHER
KfwLoanAdditionalInfo:
type: object
description: 'DE: Zustzäliche Information zum KFW Darlehen.
EN: Additional informations for kfw loan.
'
properties:
provisionDetails:
type: array
description: 'DE: Zusätzliche Provisionsdetails für das KFW Darlehen (Schlüssel-Werte Paar).
EN: Additional commission (provision) details for the kfw loan (key-value pairs).
'
items:
$ref: '#/components/schemas/AdditionalInfo'
EnergyEfficiency:
type: object
description: 'DE: Information bzgl. der Energieeffizienz.
EN: Information the regarding the energy efficency.
'
properties:
energyEfficiencyStandard:
type: string
description: 'DE: Energieeffizienz Standard nach KfW
EN: energy efficiency standard according to KfW
'
x-extensible-enum:
- KFW_EFFIZIENZHAUS_40
- KFW_EFFIZIENZHAUS_40PLUS
- KFW_EFFIZIENZHAUS_40_MIT_NACHHALTIGKEIT
- KFW_EFFIZIENZHAUS_55
- KFW_EFFIZIENZHAUS_55PLUS
- KFW_EFFIZIENZHAUS_55_MIT_NACHHALTIGKEIT
- KFW_EFFIZIENZHAUS_70
- KFW_EFFIZIENZHAUS_85
- KFW_EFFIZIENZHAUS_100
- KFW_EFFIZIENZHAUS_DENKMAL
- OTHER
energyEfficiencyClass:
type: string
description: 'DE: Energieausweis für Wohngebäude
EN: Energy certificate for residential buildings
'
x-extensible-enum:
- A_PLUS
- A
- B
- C
- D
- E
- F
- G
- H
- OTHER
description:
type: string
maxLength: 4000
description: 'DE: Beschreibung falls OTHER als standard ausgewählt wird
EN: description if OTHER is the standard
'
renewableEnergyClass:
type: boolean
nullable: true
description: 'DE: Standart gehört zur neuen Erneuerbare-Energien-Klasse
EN: Standard belongs to new renewable-energy-class
'
primaryEnergyDemand:
type: integer
minimum: 0
maximum: 100000
description: 'DE: Primärenergiebedarf (in kWh/m2 pro Jahr)
EN: Primary energy demand (kWh/m2 per year)
'
primaryEnergyConsumption:
type: integer
minimum: 0
maximum: 100000
description: 'DE: Primärenergieverbrauch nach Modernisierung (in kWh/m2 pro Jahr) - nicht relevant bei Grundstücken, sowie bei den Finanzierungsgründen Bau, Kauf Neubau
EN: primary energy consumption after modernisation (kWh/m2 per year) - not relevant for plots of land and financing reasons build, buy new building
'
carbondioxideEmissions:
type: integer
minimum: 0
maximum: 100000
description: 'DE: CO2 Emissionen (in kg/m2 pro Jahr) nach Modernisierung - nicht relevant bei Grundstücken, sowie bei den Finanzierungsgründen Bau, Kauf Neubau
EN: Carbondioxide emissions (in kg/m2 per year) after modernisation - not relevant for plots of land and financing reasons build, buy new building
'
AuxProductTypeKey:
type: string
description: 'DE: Typ des Nachrangdarlehens (nicht abschließende Aufzählung), z.B. DSL_PRIVAT, OYAK_ANKER, HANSEATIC_ALL.
EN: Open ended enum contains auxiliary loan product types, possible values are DSL_PRIVAT, OYAK_ANKER, HANSEATIC_ALL.
'
example: HANSEATIC_ALL
x-extensible-enum:
- DSL_PRIVAT
- HANSEATIC_ALL
- OYAK_ANKER
- OTHER
Household:
type: object
description: 'DE: Informationen zum Haushalt.
EN: Information regarding a Household and it''s inhabitants.
'
required:
- applicants
properties:
applicants:
type: array
description: 'DE: Sammlung von Referenzen zu den Einwohnern die zu diesem Haushalt gehören.
EN: Reference to the applicants involved in this household.
'
items:
$ref: '#/components/schemas/ApplicantIdRef'
carsHousehold:
type: integer
format: int32
description: 'DE: Anzahl PKWs im Haushalt.
EN: Number of cars in household.
'
numberOfChildren:
type: integer
format: int32
description: 'DE: Anzahl unterhaltsberechtigter Kinder im Haushalt.
EN: Number of children in household.
'
personsHousehold:
type: integer
format: int32
description: 'DE: Anzahl im Haushalt lebender Personen.
EN: Number of persons in the same household.
'
CreditPhaseInterest:
type: object
properties:
interestRate:
$ref: '#/components/schemas/InterestRate'
interestPayed:
description: 'DE: Sollzinsen insgesamt.
EN: Total of credit interest payed.
'
$ref: '#/components/schemas/EuroAmount'
InsuranceBurden:
type: object
required:
- burden
properties:
burden:
$ref: '#/components/schemas/PeriodicalEuroAmount'
minimum:
description: 'DE: Davon nicht beitragsfrei stellbar.
EN: Of which not exempt from contributions.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
FixedInterestMaturity:
description: 'DE: Information über die Sollzinsbindung mit dem festen Dauer.
EN: Information about fixed interest rate maturity.
'
type: object
required:
- type
- period
allOf:
- $ref: '#/components/schemas/BaseInterestMaturity'
properties:
period:
description: 'DE: Dauer der Sollzinsbindung.
EN: Fixed interest rate duration.
'
$ref: '#/components/schemas/Duration'
fixedUntil:
description: 'DE: Enddatum der Sollzinsbindung.
EN: End date of the fixed interest rate.
'
$ref: '#/components/schemas/ISODate'
bulletLoan:
type: boolean
description: 'DE: Endfällig.
EN: Bullet loan.
'
BasementDetail:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/BasementDetailKey'
ExistingBuildingSavingPlan:
type: object
required:
- reason
- contractNumber
description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit einem bald fälligen Bestandsbausparers.
EN: Information about bridging debt associated with a building saving plan that is due soon.
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
properties:
contractNumber:
type: string
readOnly: true
description: 'DE: Vertragsnummer eines bald fälligen Bestandsbausparers Bausparvertrags (components.schemas.BuildingSavingPlanEquity.properties.contractNumber).
EN: Contract number referring to a soon due building saving plan (components.schemas.BuildingSavingPlanEquity.properties.contractNumber).
'
Child:
type: object
description: 'DE: beschreibt ein Kind (Im Umfang der Daten reduzierte Person)
EN: a child is a segment of the data of a person
'
required:
- childId
- birthDate
properties:
childId:
type: string
description: 'DE: eindeutiger Schlüssel (ID), der die Person (hier: das Kind) identifiziert
EN: unique id referencing this person
'
birthDate:
description: 'DE: Geburtsdatum des Kindes.
EN: Date of birth of the child
'
$ref: '#/components/schemas/ISODate'
firstName:
type: string
maxLength: 100
description: 'DE: Vorname des Kindes.
EN: First name of the child.
'
lastName:
type: string
maxLength: 100
description: 'DE: Nachname der Kindes.
EN: Last name of the child.
'
childAllowanceEntitled:
type: boolean
nullable: true
description: 'DE: ist das Kind zum Bezug von Kindergeld berechtigt
EN: flag indicating whether this child is entitled to receive governmental child allowance
'
RepaymentEntriesAggregated:
type: object
required:
- burdenTotal
- interestTotal
- remainingCreditAmount
- repaymentTotal
properties:
interestTotal:
description: The sum of payed interests.
$ref: '#/components/schemas/EuroAmount'
repaymentTotal:
description: The sum of payed repayments.
$ref: '#/components/schemas/EuroAmount'
burdenTotal:
description: The sum of payed credit burdens.
$ref: '#/components/schemas/EuroAmount'
remainingCreditAmount:
description: The remaining credit amount at the end of the plan (Restschuld)
$ref: '#/components/schemas/EuroAmount'
HouseRating:
description: 'DE: Bewertung des Hauses (Gebäude und Grundstueck).
EN: Rating of a house (building and property).
'
type: object
allOf:
- $ref: '#/components/schemas/BaseRealEstateRating'
properties:
landValueEvaluation:
$ref: '#/components/schemas/LandValueEvaluation'
KfwReservationInfo:
type: object
description: 'DE: Zusätzliche Information zur KFW-Darlehensreservierung.
EN: Additional Information about the Kfw Loan reservations
'
properties:
id:
type: string
description: 'DE: Identifizierungsnummer einer sofortigen (Kfw) Bestätigung.
EN: Identification nummer for a immediate (Kfw) confirmation.
'
callType:
$ref: '#/components/schemas/KfwCallType'
conditionReservationDate:
description: 'DE: Konditionsreservierungsdatum.
EN: Condition reservation date.
'
$ref: '#/components/schemas/ISODate'
validity:
description: 'DE: Ablaufdatum der Kondition.
EN: Condition expiry date.
'
$ref: '#/components/schemas/ISODate'
OfferFinancingNeed:
description: 'DE: Information über den Finanzierungswunsch der finanziert werden sollten.
EN: Information about the financing need.
'
type: object
properties:
amount:
description: 'DE: Gewünschter Finanzierungsbetrag.
EN: Wanted amount to be financed.
'
$ref: '#/components/schemas/EuroAmount'
costs:
$ref: '#/components/schemas/OfferFinancingNeedCost'
equity:
description: 'DE: In die Finanzierung eingebrachtes Eigenkapital.
EN: Own equity used for the financing.
'
$ref: '#/components/schemas/EuroAmount'
TaxableIncome:
type: object
description: 'DE: Steuerpflichtiges Einkommen für ein bestimmtes Jahr.
EN: Taxable income for a specific years.
'
required:
- year
- taxableIncome
properties:
year:
$ref: '#/components/schemas/Year'
taxableIncome:
$ref: '#/components/schemas/PeriodicalEuroAmount'
CreditPhase:
type: object
description: The credit phase object (Darlehensphase).
properties:
amount:
description: 'DE: Tilgungssumme
EN: Loan amount to be amortized.
'
$ref: '#/components/schemas/EuroAmount'
timeline:
$ref: '#/components/schemas/CreditPhaseTimeline'
payout:
$ref: '#/components/schemas/CreditPhasePayout'
interest:
$ref: '#/components/schemas/CreditPhaseInterest'
burden:
$ref: '#/components/schemas/CreditPhaseBurden'
residualDebt:
description: 'DE: Restschuld am Sollzinsbindungsende.
EN: remaining debt by the end of the maturity.
'
$ref: '#/components/schemas/EuroAmount'
premium:
description: 'DE: Agio/ Laufzeitabhängiger Zinsbestandteil, der dem Nennbetrag des Darlehens zugeschlagen wird und damit die Darlehensschuld erhöht.
EN: Agio/ term-dependent interest component that is added to the nominal amount of the loan and thus increases the loan debt.
'
$ref: '#/components/schemas/EuroAmount'
youthBonus:
description: 'DE: Jugendbonus wenn man bei Vertragsabschluss < 26 Jahre ist.
EN: youth bonus when one at the contract''s conclusion < 26 Years old.
'
$ref: '#/components/schemas/EuroAmount'
SpecialRepaymentType:
type: string
description: 'DE: Typ der speziellen Rückzahlung (nicht abschließende Aufzählung), z.B. PERCENTAGE, TEXT.
EN: Open ended enum contains possible special repayment types, possible values are PERCENTAGE, TEXT.
'
example: PERCENTAGE
x-extensible-enum:
- PERCENTAGE
- TEXT
CompanyId:
type: object
required:
- value
description: 'DE: ID des Unternehmes. EN: ID of the company.
'
properties:
value:
type: string
ResidualDebtId:
type: object
description: 'DE: Id der Restschuldabsicherung.
EN: Id of the residual debt protection.
'
properties:
value:
type: string
TitleKey:
type: string
description: 'DE: Akademischer Titel des Antragstellers (nicht abschließende Aufzählung, zum Beispiel: DR, PH_D, PD_DR, PROF, PROF_DR).
EN: Open ended enum contains possible title values, possible values are DR, PH_D, PD_DR, PROF, PROF_DR.
'
example: PROF_DR
x-extensible-enum:
- DR
- PH_D
- PD_DR
- PROF
- PROF_DR
- OTHER
Liability:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/LiabilityKey'
Person:
type: object
required:
- name
description: 'DE: Personendaten einer Person.
EN: Personal data of a person.
'
properties:
name:
description: 'DE: Name der Person.
EN: Name of the person.
'
$ref: '#/components/schemas/PersonName'
birthDate:
description: 'DE: Geburtsdatum der Person.
EN: Date of birth of the person.
'
$ref: '#/components/schemas/ISODate'
birthPlace:
type: string
example: London
description: 'DE: Geburtsort der Person.
EN: The birth place of the person.
'
birthCountry:
description: 'DE: Geburtsland der Person.
EN: BirthCountry of the person.
'
$ref: '#/components/schemas/CountryCode'
AssignmentForSecurity:
description: 'DE: Sicherungsabtretung von Vermögen.
EN: Equity for assignment for security.
'
properties:
realEstateAssignedForSecurity:
description: 'DE: Sicherungsabtretung von Immobilienvermögen.
EN: Other realestate assigned for security.
'
$ref: '#/components/schemas/EuroAmount'
cashAssignedForSecurity:
description: 'DE: Sicherungsabtretung aus Bankguthaben.
EN: Bank balance assigned for security.
'
$ref: '#/components/schemas/EuroAmount'
mortgageSavingAssignedForSecurity:
description: 'DE: Sicherungsabtretung aus Bausparguthaben.
EN: Home savings plans assigned for security.
'
$ref: '#/components/schemas/EuroAmount'
stockForSecurity:
description: Stock amount for security.
$ref: '#/components/schemas/EuroAmount'
lifeInsuranceForSecurity:
description: Life insurance policies for security.
$ref: '#/components/schemas/EuroAmount'
OtherOccupation:
type: object
description: 'DE: Nicht näher spezifizierte Erwerbstätigkeit.
EN: Unspecified Occupation.
'
allOf:
- $ref: '#/components/schemas/BaseOccupation'
properties:
shareHolding:
$ref: '#/components/schemas/ShareHolding'
jobInformation:
$ref: '#/components/schemas/JobInformation'
parentalLeave:
$ref: '#/components/schemas/ParentalLeave'
PaymentTime:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PaymentTimeKey'
EvaluationInformation:
type: object
properties:
source:
description: 'DE: Infoquelle des aktuellen Marktwert der Immobilie oder Grundstücks.
EN: Source for the current estate or land value evaluation.
'
$ref: '#/components/schemas/StatSource'
date:
description: 'DE: Datum der Bewertung.
EN: Date of the evaluation.
'
$ref: '#/components/schemas/ISODate'
contact:
description: 'DE: Kontaktinformation bei Rückfragen zur Bewertung.
EN: Contact information for the evaluation.
'
$ref: '#/components/schemas/EvaluationInformationContactData'
OccupationType:
type: string
description: 'DE: Beschreibung der Beschäftigungsart (nicht abschließende Aufzählung, zum Beispiel: EMPLOYEE = ANGESTELLTE/R, WORKER = ARBEITER/IN, UNEMPLOYED = ARBEITSLOSE/R, OFFICIAL = BEAMTE/R, PARENTAL_LEAVE = ELTERNZEIT, FREELANCER = FREIBERUFLER/IN, MARGINALLY_EMPLOYED = GERINFÜGIG BESCHÄFTIGT, STOCKHOLDER = GESCHÄFTSF. GESELLSCHAFTER/IN, HOUSE_WIFE_OR_HUSBAND = HAUSMANN/FRAU, INDEPENDENT_GENTLEMAN = PRIVATIER/E, SELF_EMPLOYED_WITH_BALANCING = SELBSTSTÄNDIGE/R (bilanzierend), SELF_EMPLOYED_WITHOUT_BALANCING = SELBSTSTÄNDIGE/R (nicht bil.), PENSIONER = RENTNER/IN oder PENSIONÄR/IN, STUDENT = STUDENT/IN, SOLDIER = SOLDAT/IN, EXECUTIVE = VORSTAND/VORSTÄNDIN).
EN: Open ended enum contains values for the occupation types, possible values are EMPLOYEE, WORKER, UNEMPLOYED, OFFICIAL, PARENTAL_LEAVE, FREELANCER, MARGINALLY_EMPLOYED, STOCKHOLDER, HOUSE_WIFE_OR_HUSBAND, INDEPENDENT_GENTLEMAN, SELF_EMPLOYED_WITH_BALANCING, SELF_EMPLOYED_WITHOUT_BALANCING, PENSIONER, STUDENT, SOLDIER, EXECUTIVE.
'
example: EMPLOYEE
x-extensible-enum:
- EMPLOYEE
- WORKER
- UNEMPLOYED
- OFFICIAL
- PARENTAL_LEAVE
- FREELANCER
- MARGINALLY_EMPLOYED
- STOCKHOLDER
- HOUSE_WIFE_OR_HUSBAND
- INDEPENDENT_GENTLEMAN
- SELF_EMPLOYED_WITH_BALANCING
- SELF_EMPLOYED_WITHOUT_BALANCING
- PENSIONER
- STUDENT
- SOLDIER
- EXECUTIVE
OriginalPurchase:
type: object
properties:
price:
description: 'DE: Ursprünglicher Kaufpreis der Immobilie.
EN: Initial property purchase price.
'
$ref: '#/components/schemas/EuroAmount'
year:
description: 'DE: Jahr des Kaufes / der Fertigstellung.
EN: Year of payment / Year of completion.
'
$ref: '#/components/schemas/Year'
LivingAddress:
type: object
required:
- address
- fromDate
description: "DE: Adresse des aktuellen oder eines früheren Wohnorts
\nEN: address of a living place, current or past.\n"
properties:
address:
$ref: '#/components/schemas/Address'
fromDate:
description: "DE: Beginn des Gültigkeitszeitraums dieser Adresse (= Einzugsdatum). Aufgrund von Änderungen im Schema kann das Datum den Wert 1970-01-01 enthalten, da kein anderer Wert verfügbar ist.
\nEN: Begin of validity period of this address (= date of moving in). Due to migration may contain EPOCH (1970-01-01) date because no other value is available to be set.\n"
$ref: '#/components/schemas/ISODate'
toDate:
description: "DE: Ende des Gültigkeitszeitraums dieser Adresse (= Auszugsdatum). Wenn leer, dann ist dies noch die aktuelle Adresse. Aufgrund von Änderungen im Schema kann das Datum den Wert 1970-01-01 enthalten, da kein anderer Wert verfügbar ist.
\nEN: End of validity period of this address (= date of moving in). If empty this is the current living address. Due to migration may contain EPOCH (1970-01-01) date because no other value is available to be set.\n"
$ref: '#/components/schemas/ISODate'
SuspendedAmortizationOtherProduct:
type: object
allOf:
- $ref: '#/components/schemas/BaseSuspendedAmortizationCombinedProduct'
ExistingDebtType:
type: string
description: 'DE: Art der Darlehen (nicht abschließende Aufzaehlung EMPLOYMENT, PRIVATE, MORTGAGE_SAVING_PLAN, PUBLIC, OTHER, SOLVENCY, EXISTING_MORTGAGE, OPEN_PROPERTY_SALE, EXISTING_REALESTATE).
EN: Open ended enum contains existing loan debt type, possible values are (EMPLOYMENT, PRIVATE, MORTGAGE_SAVING_PLAN, PUBLIC, OTHER, SOLVENCY, EXISTING_MORTGAGE, OPEN_PROPERTY_SALE, EXISTING_REALESTATE).
'
example: EMPLOYMENT
x-extensible-enum:
- EMPLOYMENT
- PRIVATE
- MORTGAGE_SAVING_PLAN
- PUBLIC
- SOLVENCY
- OTHER
- EXISTING_MORTGAGE
- OPEN_PROPERTY_SALE
- EXISTING_REALESTATE
SuspendedAmortizationBuildingSavingProduct:
type: object
allOf:
- $ref: '#/components/schemas/BaseSuspendedAmortizationCombinedProduct'
properties:
productDetails:
description: 'EN: details to the building saving plan being created. Only relevant when the building saving plan will be created during the credit decision process.
'
$ref: '#/components/schemas/BuildingSavingPlan'
productIdentifier:
type: string
ParkingSpaceTypeKey:
type: string
example: DUPLEX_GARAGE
x-extensible-enum:
- OUTSIDE_PARKING_SPACE
- UNDERGROUND_GARAGE
- DUPLEX_GARAGE
- CARPORT_GARAGE
- SEPARATE_GARAGE
- DOUBLE_GARAGE
Margin:
title: Margin
type: object
additionalProperties: false
required:
- name
properties:
name:
type: string
description: Name der Marge
value:
description: Wert der Marge in Prozent
$ref: '#/components/schemas/RawPercentage'
CessionClaim:
type: object
description: 'DE: Information zur Abtretung der Grundschuld.
EN: Information about the cession of the land charge.
'
required:
- requested
properties:
requested:
description: 'DE: Flag ob eine Abtretung der Grundschuld erwünscht wird.
EN: Flag whether a cession of the land charge is desired
'
type: boolean
discriminator:
propertyName: requested
mapping:
true: '#/components/schemas/CessionClaimRequested'
false: '#/components/schemas/NoCessionClaim'
OtherExpense:
type: object
required:
- value
description: 'DE: Andere (zusätzliche) regelmäßige Ausgaben.
EN: Other periodical expenses.
'
properties:
value:
$ref: '#/components/schemas/PeriodicalEuroAmount'
description:
type: string
EvaluationInformationContactData:
type: object
properties:
description:
example: Gemeinde Musterstadt
description: 'DE: Kontaktinformationbeschreibung.
EN: Description about the contact for the evaluation.
'
type: string
phone:
description: 'DE: Telefonnummer des Ansprechspartner für die Bewertung.
EN: Phone number of the contact person for evaluation.
'
type: string
Estates:
type: object
description: 'A wrapper type of items which hold the essential estate information.
'
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/EstateItem'
minItems: 1
SimpleLoanDebt:
type: object
required:
- until
- amount
description: 'DE: Information zu bestehenden Darlehen.
EN: Information about existing debts.
'
allOf:
- $ref: '#/components/schemas/BaseExistingLoanDebt'
properties:
amount:
description: 'DE: Ursprünglicher Darlehenbetrag.
EN: Original debt amount.
'
$ref: '#/components/schemas/EuroAmount'
residualDebt:
description: 'DE: Aktuelle Restschuld.
EN: Current remaining debt.
'
$ref: '#/components/schemas/EuroAmount'
interestFixDate:
description: 'DE: Ablauf Sollzinsbindung.
EN: Expiry of fixed interest rate.
'
$ref: '#/components/schemas/ISODate'
description:
description: 'DE: Beschreibung der bereitgestellten Schuld. EN: Description of the provided debt.
'
type: string
interestRate:
description: 'DE: Nominalzins (Sollzins)
EN: Nominal interest rate
'
$ref: '#/components/schemas/PeriodicalPercentage'
BankAccount:
type: object
description: 'DE: Kontoverbindungsdaten
EN: Bank account data
'
required:
- iban
- accountOwner
properties:
iban:
description: 'DE: IBAN
EN: The International Bank Account Number
'
$ref: '#/components/schemas/Iban'
accountOwner:
type: string
description: 'DE: Name des Kontobesitzers
EN: The name of the account owner
'
bic:
description: 'DE: BIC
EN: The Business Identifier Code
'
$ref: '#/components/schemas/Bic'
bank:
type: string
description: 'DE: Name der Bank
EN: The name of the bank
'
selectedForPayments:
type: boolean
nullable: true
description: 'DE: Ist das Bankverbindung für alle SEPA-Lastschriften verwenden
EN: Is the bank account used for all SEPA debits
'
selectedForPayout:
type: boolean
nullable: true
description: 'DE: Ist Bankverbindung für alle Auszahlungen verwenden
EN: Is the bank account used for all payouts
'
BaseSpecialRealEstateCharacteristics:
type: object
description: 'DE: Spezielle Nutzung der Immobilie.
EN: Special use of property.
'
required:
- type
properties:
type:
type: string
careProperty:
description: 'DE: Betreutes Wohnen.
EN: Assisted living.
'
type: boolean
nullable: true
holidayProp:
description: 'DE: Ferienimmobilie.
EN: Holiday property.
'
type: boolean
nullable: true
luxury:
description: 'DE: Luxusobjekt.
EN: Luxury estate.
'
type: boolean
nullable: true
monumentProtection:
description: 'DE: Objekt unter Denkmalschutz.
EN: Estate under monument protection.
'
type: boolean
nullable: true
microApartment:
description: 'DE: Miniapartment.
EN: Micro apartment
'
type: boolean
nullable: true
tinyHouse:
description: 'DE: Tiny Haus.
EN: Tiny house
'
type: boolean
nullable: true
retirementResidence:
description: 'DE: Seniorenresidenz.
EN: Retirement residence
'
type: boolean
nullable: true
discriminator:
propertyName: type
PreviousOwner:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/PreviousOwnerKey'
InterestMaturity:
oneOf:
- $ref: '#/components/schemas/VariableInterestMaturity'
- $ref: '#/components/schemas/FixedInterestMaturity'
discriminator:
propertyName: type
mapping:
VARIABLE: '#/components/schemas/VariableInterestMaturity'
FIXED_PERIOD: '#/components/schemas/FixedInterestMaturity'
RawPercentage:
description: 'DE: Prozentsatz.
EN: Percentage.
'
type: object
required:
- value
properties:
value:
description: 'DE: Prozentsatz.
EN: Percentage.
'
type: number
BrokeragePlatformIdentifier:
type: object
properties:
key:
$ref: '#/components/schemas/BrokeragePlatformIdentifierKey'
value:
type: string
description: 'DE: Beratungsunternehmenidentifikator - Vermittlernummer.
EN: Advisor company identifier.
'
Phone:
type: object
required:
- phoneNumber
- type
properties:
phoneNumber:
type: string
description: 'DE: Mobil- oder Festnetztelefonnummer des Antragstellers.
EN: Mobile or landline telephone number of the customer.
'
example: +49 160 123456
type:
$ref: '#/components/schemas/PhoneType'
reachable:
$ref: '#/components/schemas/PhoneReachability'
FamilyIncome:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch bzw. für Kinder / Familie.
EN: Additional periodical income for children / family.
'
type: object
properties:
alimony:
$ref: '#/components/schemas/AlimonyInfo'
childAllowance:
description: 'DE: Kindergeld.
EN: Child Allowance.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
parentalAllowance:
$ref: '#/components/schemas/ParentalAllowanceInfo'
RentPeriodTypeKey:
type: string
description: 'DE: Mietdauer, z.B. befristet, unbefristet oder unvermietet.
EN: Open ended enum contains rent period, possible values are (LIMITED, UNLIMITED, UNRENTED).
'
x-extensible-enum:
- LIMITED
- UNLIMITED
- UNRENTED
NationalityType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/NationalityTypeKey'
SubmissionRef:
type: object
description: 'A reference to a specific submisson resource.
This reference consists of a link which leads directly to the resource and an Id which could be used to reconstruct the url.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
id:
$ref: '#/components/schemas/SubmissionId'
ConditionProductCalculation:
description: 'DE: Information über Konditionskalkulation.
EN: Information about condition calculation.
'
type: object
required:
- type
- details
- margen
allOf:
- $ref: '#/components/schemas/BaseProductCalculation'
properties:
details:
$ref: '#/components/schemas/ConditionCalculationDetails'
margen:
$ref: '#/components/schemas/MarginDetails'
commission:
x-is-plural: true
type: array
items:
$ref: '#/components/schemas/CommissionCalculationInfo'
Applicants:
type: object
description: 'A wrapper type which holds the essential applicant information.
'
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/ApplicantItem'
minItems: 1
PropertyType:
type: string
description: 'DE: Art des Gebäudes (nicht abschließende Aufzählung), z.B. APARTMENT=Wohnung, DETACHED_HOUSE=Einfamilienhaus, SEMI_DETACHED_HOUSE=Doppelhaushälfte, TWO_FAMILY_HOUSE=Zweifamilienhaus, END_TERRACE_HOUSE=Reiheneckhaus, MID_TERRACE_HOUSE=Reihenmittelhaus, APARTMENT_BUILDING=Mehrfamilienhaus, RESIDENTIAL_AND_COMMERCIAL_BUILDING=Wohn_und_Geschäftshaus, PROPERTY=nur_Grundstück, COMMERCIAL_PROPERTY=gewerb. Grundstück .
EN: open ended enum contains property type details, possible values are APARTMENT, DETACHED_HOUSE, SEMI_DETACHED_HOUSE, TWO_FAMILY_HOUSE, END_TERRACE_HOUSE, MID_TERRACE_HOUSE, APARTMENT_BUILDING, RESIDENTIAL_AND_COMMERCIAL_BUILDING, PROPERTY, COMMERCIAL_PROPERTY.
'
example: APARTMENT
x-extensible-enum:
- APARTMENT
- DETACHED_HOUSE
- SEMI_DETACHED_HOUSE
- TWO_FAMILY_HOUSE
- END_TERRACE_HOUSE
- MID_TERRACE_HOUSE
- APARTMENT_BUILDING
- RESIDENTIAL_AND_COMMERCIAL_BUILDING
- PROPERTY
- COMMERCIAL_PROPERTY
SavingsEntry:
type: object
description: The object for a single savings entry regarding the cash flow.
required:
- accountBalance
- fees
- savingsBurden
- savingsInterest
properties:
savingsBurden:
description: The savings burden in EUR (Sparrate).
$ref: '#/components/schemas/EuroAmount'
capitalFormationSavings:
description: The capital formation savings in EUR (Vermögenswirksame Leistungen).
$ref: '#/components/schemas/EuroAmount'
savingsInterest:
description: The savings interest in EUR (Guthabenzins).
$ref: '#/components/schemas/EuroAmount'
fees:
description: The fees in EUR (Gebühren).
$ref: '#/components/schemas/EuroAmount'
accountBalance:
description: The account balance in EUR (Kontostand).
$ref: '#/components/schemas/EuroAmount'
SchufaRating:
type: object
required:
- type
description: 'DE: Bewertung der Kreditwürdigkeit des Antragstellers durch die Schufa.
EN: Rating of the credit worthiness by Schufa.
'
allOf:
- $ref: '#/components/schemas/BaseCreditWorthiness'
properties:
hasNegativeSchufaEntry:
type: boolean
nullable: true
description: "DE: WAHR, wenn ein negativer Schufa-Krediteintrag vorhanden ist.
\n EN: TRUE, if there is a negative schufa entry.\n"
ratingStep:
type: string
description: 'DE: Schufa Rating-Stufe zur Kreditwürdigkeit (nicht abschließende Aufzählung, zum Beispiel: A, B, C, D, E, F, G, H, I, J, K, L, M). Mehr Informationen unter: Schufa-Score.
EN: open ended enum contains a rating value of the credit worthiness if any, possible values are A, B, C, D, E, F, G, H, I, J, K, L, M. More information: Schufa-Score.
'
example: A
x-extensible-enum:
- A
- B
- C
- D
- E
- F
- G
- H
- I
- J
- K
- L
- M
score:
type: number
minimum: 0
maximum: 100
format: float
example: 97.5
description: 'DE: Schufa Basisscore der Kreditwürdigkeit (zum Beispiel: 97.55 -> sehr geringes Risiko).
EN: Contains a score value of the credit worthiness (e.g. Schufa 97.5 -> very low risk).
'
SpecialPropertyTypeKey:
type: string
description: 'DE: Sondereigentumstyp (nicht abschließende Aufzählung), z.B. BASEMENT, HOBBY, DRYING_ROOM, ATTIC, OFFICE, APARTMENT, ALL_ROOMS, GARAGE, OUT_PARK, UG_PARK, DUPLEX_PARK, GROUND, TOWNHOUSE_CORNER, TOWNHOUSE_CENTER, SEMIDETACHED_HOUSE.
EN: open ended enum contains unit Property details, possible values are (BASEMENT, HOBBY, DRYING_ROOM, ATTIC, OFFICE, APARTMENT, ALL_ROOMS, GARAGE, OUT_PARK, UG_PARK, DUPLEX_PARK, GROUND, TOWNHOUSE_CORNER, TOWNHOUSE_CENTER, SEMIDETACHED_HOUSE)
'
example: BASEMENT
x-extensible-enum:
- BASEMENT
- HOBBY
- DRYING_ROOM
- ATTIC
- OFFICE
- APARTMENT
- ALL_ROOMS
- GARAGE
- OUT_PARK
- UG_PARK
- DUPLEX_PARK
- GROUND
- TOWNHOUSE_CORNER
- TOWNHOUSE_CENTER
- SEMIDETACHED_HOUSE
- OTHER
ApplicantRelationship:
type: object
description: 'DE: Beziehung zwischen genau zwei für Antrag relevanten Antragstellern. Wenn dieses Objekt nicht vorhanden ist, dann ist existieren keine Beziehungen.
EN: Relationship between exactly 2 applicants involved in the financing application when applicable.
The absence of this object indicates that no relationship is available.
'
required:
- relationType
properties:
applicants:
description: 'DE: Referenzen zu den in der Beziehung involvierten Antragstellern.
EN: Reference to the applicants involved in this relationship.
'
type: array
minItems: 2
maxItems: 2
items:
$ref: '#/components/schemas/ApplicantIdRef'
relationType:
$ref: '#/components/schemas/ApplicantRelationshipType'
PeriodicalPercentage:
description: 'DE: Periodischer Prozentsatz als double.
EN: Periodical percentage as double.
'
type: object
required:
- percentage
- cycle
properties:
percentage:
$ref: '#/components/schemas/Percentage'
cycle:
$ref: '#/components/schemas/Cycle'
Apartment:
description: 'DE: Zusätzliche Information zu der Immobilie von Typ "APARTMENT" (Wohnung).
EN: Additional Information for the estate with the type "APARTMENT".
'
type: object
allOf:
- $ref: '#/components/schemas/RealEstate'
properties:
rating:
$ref: '#/components/schemas/RealEstateRating'
numberOfApartmentsPerResidence:
description: 'DE: Anzahl der Wohnungen im gesamten Wohnhaus.
EN: Total number of apartments within the whole residence building.
'
type: integer
format: int32
apartmentsPerEntrance:
description: 'DE: Anzahl der Wohnungen pro Hausaufgang.
EN: Apartments per building entrance (staircase).
'
type: integer
format: int32
apartmentsPerBuilding:
description: 'DE: Anzahl der Wohnungen pro Haus.
EN: Apartments per building.
'
type: integer
format: int32
apartmentsPerDivision:
description: 'DE: Anzahl Wohnung pro Teilungserklärung.
EN: Apartments per apartment declaration of division.
'
type: integer
format: int32
apartmentFloor:
$ref: '#/components/schemas/ApartmentFloor'
specialCharacteristics:
$ref: '#/components/schemas/SpecialRealEstateCharacteristics'
OAuthProblem:
type: object
description: Error while Authentication
required:
- error
- error_description
properties:
error:
type: string
description: Summary of the error type
example: invalid_token
error_description:
type: string
description: Detailed information about the error
example: Access token expired
CountryCode:
type: object
description: 'DE: Ländercode nach ISO_3166-1_alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
EN: Official ISO_3166-1_alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
'
required:
- value
properties:
value:
type: string
example: DE
pattern: ^[A-Z]{2}$
ResidualDebtProtection:
oneOf:
- $ref: '#/components/schemas/ResidualDebtProtectionBuildingSavingPlan'
discriminator:
propertyName: type
mapping:
BUILDING_SAVING_PLAN: '#/components/schemas/ResidualDebtProtectionBuildingSavingPlan'
ConditionCalculationDetails:
description: 'DE: Information über einzelnen Darlehen innerhalb des Konditionskalkulations.
EN: Information about single loan which is a part of condition calculation.
'
type: object
required:
- amount
- payout
- maturity
- baserate
- paymentTime
- interestDetails
properties:
amount:
description: 'DE: Darlehensbetrag.
EN: Loan amount.
'
$ref: '#/components/schemas/RawEuroAmount'
payout:
description: 'DE: Auszahlung (Prozent).
EN: Payout (percent).
'
$ref: '#/components/schemas/RawPercentage'
maturity:
description: 'DE: Dauer der Sollzinsbindung.
EN: Duration of interest rate maturity.
'
$ref: '#/components/schemas/InterestMaturity'
baserate:
$ref: '#/components/schemas/CalculationBaseRate'
paymentTime:
$ref: '#/components/schemas/PaymentTime'
interestDetails:
$ref: '#/components/schemas/LoanConditionInterest'
HouseUtilityUnits:
type: object
description: 'DE: Wohn- und Nutzeinheiten.
EN: Residential and utility units.
'
properties:
numberOfUnits:
type: integer
format: int32
unitGroups:
$ref: '#/components/schemas/HouseUtilityUnitGroups'
InhabitantsKey:
type: string
description: 'DE: Anzahl Einwohner im Ort (nicht abschließende Aufzählung), z.B. UP_TO_1000, UP_TO_10000, UP_TO_50000, UP_TO_100000, UP_TO_200000, UP_TO_500000, UP_TO_1000000, MORE_THEN_1000000.
EN: open ended enum contains umber of inhabitants in the city, possible values are UP_TO_1000, UP_TO_10000, UP_TO_50000, UP_TO_100000, UP_TO_200000, UP_TO_500000, UP_TO_1000000, MORE_THEN_1000000.
'
example: UP_TO_1000
x-extensible-enum:
- UP_TO_1000
- UP_TO_10000
- UP_TO_50000
- UP_TO_100000
- UP_TO_200000
- UP_TO_500000
- UP_TO_1000000
- MORE_THEN_1000000
- OTHER
RegulatoryAuthorityLegalBasis:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/RegulatoryAuthorityLegalBasisKey'
ConsultationItem:
type: object
required:
- _href
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
embedded:
$ref: '#/components/schemas/Consultation'
ApplicantId:
type: object
required:
- value
properties:
value:
description: 'DE: Id des Antragstellers.
EN: Id of the applicant.
'
type: string
example: '1'
BasementExtensionForResidentialUseKey:
type: string
description: 'DE: Details zum Kellerausbau (für Wohnnutzung), z.B DEVELOPED=voll ausgebaut, PARTIALY_DEVELOPED=teilweise ausgebaut, NONE=nicht ausgebaut.
EN: Open ended enum contains basement extension for residential use, possible values are DEVELOPED, PARTIALY_DEVELOPED, NONE.
'
example: DEVELOPED
x-extensible-enum:
- DEVELOPED
- PARTIALLY_DEVELOPED
- NONE
- OTHER
PlannedHeatingModernisationDetails:
type: object
allOf:
- $ref: '#/components/schemas/BasePlannedModernisationDetails'
description: 'DE: Information über die geplante Modernisierungen der Heizung.
EN: Information about planned heating modernisations.
'
required:
- modernisationType
- replacingExistingOilHeating
- newHeatingType
properties:
replacingExistingOilHeating:
type: boolean
description: 'DE: Wird eine existierende Ölheizung ersetzt Ja - Nein
EN: flag indicating an existing oil heating is replaced
'
newHeatingType:
type: string
x-extensible-enum:
- GAS_CONDENSING_HEATING
- GAS_HYBRID_HEATING
- SOLAR_THERMAL_HEATING
- HEAT_PUMP
- BIOMASS_HEATING
- HYBRID_HEATING_WITH_RENEWABLE_ENERGY
- BUILDING_NETWORK_25_PERCENTAGE_RENEWABLE
- BUILDING_NETWORK_55_PERCENTAGE_RENEWABLE
- OTHER
description: 'DE: Typ der neuen Heizungs
EN: type of new heating
'
newHeatingDescription:
type: string
maxLength: 4000
description: 'DE: Relevant falls bei newHeatingType OTHER ausgewählt wird
EN: description of new heating if type OTHER is selected
'
PropertyRegisterOwner:
oneOf:
- $ref: '#/components/schemas/PropertyRegisterOwnerApplicant'
- $ref: '#/components/schemas/PropertyRegisterOwnerThirdPerson'
discriminator:
propertyName: type
mapping:
APPLICANT: '#/components/schemas/PropertyRegisterOwnerApplicant'
THIRD_PERSON: '#/components/schemas/PropertyRegisterOwnerThirdPerson'
RealEstatePropertyCondition:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/RealEstatePropertyConditionKey'
AdditionalInfo:
type: object
description: 'DE: Zusätzliche Information als Schlüssel-Wert Paar.
EN: Additional Information as key-value pairs.
'
properties:
key:
type: string
value:
type: string
CompanyAdvisor:
type: object
required:
- companyAddress
properties:
companyName:
type: string
description: 'DE: Name der Firma für welche der Berater arbeitet.
EN: Name of the advisor company.
'
companyAddress:
description: 'DE: Adresse des Beratungsunternehmens.
EN: Address of the advisory company.
'
$ref: '#/components/schemas/Address'
regulatoryAuthorities:
$ref: '#/components/schemas/RegulatoryAuthority'
ConstructionKey:
type: string
description: 'DE: Bauweise des Gebäudes (nicht abschließende Aufzählung), z.B. SOLID=Massivbauweise, CONCRETE_SLAB=Plattenbauweise, WOOD_STAND=Holzständerbauweise, WOOD=Holzbauweise, TIMBER_FRAMING=Fachwerkbauweise, LOG_BUILDING=Blockhausbauweise, COB=Lehmbauweise.
EN: open ended enum contains construction of the property, possible values are SOLID, CONCRETE_SLAB, WOOD_STAND, WOOD, TIMBER_FRAMING, LOG_BUILDING, COB, OTHER
'
example: SOLID
x-extensible-enum:
- SOLID
- CONCRETE_SLAB
- WOOD_STAND
- WOOD
- TIMBER_FRAMING
- LOG_BUILDING
- COB
- OTHER
Construction:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ConstructionKey'
LocalPriceDetails:
type: object
description: 'DE: Ortsüblicher Preis pro Quadratmeter Wohnfläche.
EN: Local price per square meter of living space.
'
properties:
value:
$ref: '#/components/schemas/EuroAmountPerSquareMeter'
evaluationInformation:
$ref: '#/components/schemas/EvaluationInformation'
ConstructionCostInvoice:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ConstructionCostInvoiceKey'
BasePropertiesRegisterInventory:
description: 'DE: Grundstück und Eigentum (Eintrag aus dem Bestandsverzeichnis des Grundbuchblattes).
EN: Land and property (Entry from the inventory of the land register sheet).
'
type: object
required:
- parcelAndDistrict
- type
properties:
type:
type: string
x-extensible-enum:
- OWNERSHIP_INVENTORY
- JOINT_OWNERSHIP_INVENTORY
id:
description: 'DE: Laufende Nummer des Grundstücks.
EN: Serial number of the property.
'
$ref: '#/components/schemas/PropertyRegisterInventoryId'
parcelAndDistrict:
description: 'DE: Gemarktung und Flurstück.
EN: Cadastral district and land parcel
'
$ref: '#/components/schemas/ParcelAndDistrict'
parcelDesc:
description: 'DE: Wirschaftsart und Lage.
EN: Economic type and location.
'
type: string
parcelSize:
description: 'DE: Größe des Flurstücks.
DE: Size of the parcel.
'
$ref: '#/components/schemas/SquareMeter'
discriminator:
propertyName: type
ShareHolding:
description: 'DE: Anteilsquote am Unternehmen.
EN: Shareholding quota of the company.
'
type: object
required:
- value
properties:
value:
type: number
format: double
minimum: 0
maximum: 100
FinancialStandingId:
type: object
description: 'Id of a specific FinancialStanding.
'
required:
- value
properties:
value:
type: string
MainLoan:
description: 'DE: Information zum Hauptdarlehen.
EN: Information about the main loan.
'
type: object
required:
- product
allOf:
- $ref: '#/components/schemas/BaseLoan'
properties:
product:
$ref: '#/components/schemas/MainProduct'
rateDetails:
description: 'DE: Detailinformation zu den Raten.
EN: Detailed information about the rates.
'
$ref: '#/components/schemas/RateDetails'
additionalInfo:
$ref: '#/components/schemas/MainLoanAdditionalInfo'
HousingExpense:
type: object
required:
- currentHousingSituation
description: 'DE: Informationen zu Wohnungsausgaben.
EN: Information regarding housing expenses.
'
properties:
currentHousingSituation:
$ref: '#/components/schemas/HousingSituation'
costs:
description: 'DE: Derzeitige Wohnkosten
EN: Current housing costs.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
costsObsolete:
type: boolean
nullable: true
description: 'DE: Wahr, wenn die Wohnungsausgaben nach der Finanzierung entfallen.
EN: True if accommodation/housing costs are obsolete after financing.
'
LoanToValueRatioBreakdown:
title: LoanToValueRatioBreakdown
type: object
required:
- lendingValueBreakdown
- loanBreakdown
- loanToValueRatio
properties:
lendingValueBreakdown:
$ref: '#/components/schemas/LoanToValueRatioLendingBreakdown'
loanBreakdown:
$ref: '#/components/schemas/LoanToValueRatioLoanBreakdown'
loanToValueRatio:
description: Der Beleihungsauslauf in Prozent
$ref: '#/components/schemas/RawPercentage'
UnionInfo:
oneOf:
- $ref: '#/components/schemas/DefaultUnionInfo'
- $ref: '#/components/schemas/UnionInfoDBB'
discriminator:
propertyName: organisation
mapping:
DBB: '#/components/schemas/UnionInfoDBB'
VERDI: '#/components/schemas/DefaultUnionInfo'
IG_BAU: '#/components/schemas/DefaultUnionInfo'
NGG: '#/components/schemas/DefaultUnionInfo'
DBWV: '#/components/schemas/DefaultUnionInfo'
THW_NRW: '#/components/schemas/DefaultUnionInfo'
OTHER: '#/components/schemas/DefaultUnionInfo'
BaseFinancingNeed:
type: object
required:
- type
properties:
additionalCosts:
$ref: '#/components/schemas/EstateAdditionalCosts'
type:
$ref: '#/components/schemas/FinancingNeedType'
ParkingSpaceType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/ParkingSpaceTypeKey'
OtherCapitalNeededLoanUsageKey:
type: string
description: 'DE: Zusätzlicher Kapitalbedarf (nicht abschließende Aufzählung), z.B. OPERATIONAL_COSTS, REPAY_ANOTHER_LOAN, PREPAYMENT_PENALTY, RESIDENTIAL_USE, RENEWABLE_ENERGY, DISBURSMENT_COOWNERS, DISBURSMENT_HEIRS, OTHER, RECONSTRUCTION, BUY, CONSTRUCTION, BUY_CONSTRUCTION, SUPPLEMENTARY_FINANCING.
EN: Open ended enum contains other capital needed loan usage, possible values are OPERATIONAL_COSTS, REPAY_ANOTHER_LOAN, PREPAYMENT_PENALTY, RESIDENTIAL_USE, RENEWABLE_ENERGY, DISBURSMENT_COOWNERS, DISBURSMENT_HEIRS, OTHER, RECONSTRUCTION, BUY, CONSTRUCTION, BUY_CONSTRUCTION, SUPPLEMENTARY_FINANCING.
'
example: OPERATIONAL_COSTS
x-extensible-enum:
- REFINANCE
- OPERATIONAL_COSTS
- REPAY_ANOTHER_LOAN
- PREPAYMENT_PENALTY
- RESIDENTIAL_USE
- RENEWABLE_ENERGY
- DISBURSMENT_COOWNERS
- DISBURSMENT_HEIRS
- RECONSTRUCTION
- BUY
- CONSTRUCTION
- BUY_CONSTRUCTION
- SUPPLEMENTARY_FINANCING
- OTHER
EstateVendor:
description: 'DE: Informationen über den Immobilienverkäufer.
EN: Information about the estate vendor.
'
oneOf:
- $ref: '#/components/schemas/PersonVendor'
- $ref: '#/components/schemas/CompanyVendor'
discriminator:
propertyName: vendorType
mapping:
PERSON: '#/components/schemas/PersonVendor'
COMPANY: '#/components/schemas/CompanyVendor'
LiabilityDebt:
type: object
description: 'DE: Verbindlichkeiten vor Beginn der angefragten Finanzierung.
EN: Liability obligations before the financing process.
'
properties:
guarantee:
description: 'DE: Bürgschaftsverpflichtungen.
EN: Guarantee obligations.
'
$ref: '#/components/schemas/EuroAmount'
other:
description: 'DE: Sonstige Verbindlichkeiten.
EN: Other liabilities.
'
$ref: '#/components/schemas/EuroAmount'
description:
type: string
Cycle:
description: 'DE: Wrapper für Zykluswerte
EN: Wrapper for cycle values.
'
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/CycleKey'
InvestEquity:
type: object
description: 'DE: Vermögenswerte, welche (operativ) in die Finanzierung aufgenommen werden sollen.
EN: Operational (venture) assets used in the financing process.
'
properties:
cash:
description: 'DE: Bankguthaben.
EN: Cash amount.
'
$ref: '#/components/schemas/EuroAmount'
mortgageSaving:
description: 'DE: Bausparguthaben.
EN: Mortgage savings.
'
$ref: '#/components/schemas/EuroAmount'
mortgageSavingPlans:
description: 'DE: Details über Bausparguthaben.
EN: Details about Mortgage savings.
'
type: array
items:
$ref: '#/components/schemas/BuildingSavingPlanInvestEquity'
otherEstates:
description: 'DE: Weiteres Immobilienvermögen (Marktwert).
EN: Other real estate assets (market value).
'
$ref: '#/components/schemas/EuroAmount'
personalContribution:
description: 'DE: Eigenleistung ("Muskelhypothek").
EN: Personal contribution.
'
$ref: '#/components/schemas/EuroAmount'
stock:
description: 'DE: Wertpapiere wie z.B. aktien.
EN: Securities e.g. stocks, bonds.
'
$ref: '#/components/schemas/EuroAmount'
depositPaidInAdvance:
description: 'DE: Bereits geleistete Anzahlung.
EN: Deposit already paid in advance.
'
$ref: '#/components/schemas/EuroAmount'
landPaidInAdvance:
description: 'DE: Bereits geleistete Anzahlung für das Grundstück.
EN: Deposit paid in advance for the land.
'
$ref: '#/components/schemas/EuroAmount'
relevantLoans:
type: array
description: 'DE: Sammlung von Darlehen die für das Finanzierungsvorhaben relevant sind.
EN: Collection of loans relevant for the planed financing venture.
'
items:
$ref: '#/components/schemas/VentureRelevantLoan'
ResidualDebtProtectionBuildingSavingPlan:
allOf:
- $ref: '#/components/schemas/BaseResidualDebtProtection'
- type: object
required:
- buildingSavingPlan
properties:
buildingSavingPlan:
$ref: '#/components/schemas/BuildingSavingPlan'
BusinessLine:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/BusinessLineKey'
UtilizationKey:
type: string
description: 'DE: Nutzung des Ojektes (nicht abschließende Aufzählung), z.B. SELF_OCCUPIED, PARTLY_RENT_OUT, RENT_OUT.
EN: Open ended enum contains utilization of the property, possible values are SELF_OCCUPIED, PARTLY_RENT_OUT, RENT_OUT.
'
example: SELF_OCCUPIED
x-extensible-enum:
- SELF_OCCUPIED
- PARTLY_RENT_OUT
- RENT_OUT
ClosedPropertySale:
description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit einem abgeschlossenen Immobilienverkauf.
EN: Bridging debt associated with a closed property sale.
'
allOf:
- $ref: '#/components/schemas/BaseBridgingLoanDetails'
BuildingSavingPlanInvestEquity:
type: object
required:
- contractNumber
- amount
properties:
contractNumber:
type: string
description: 'DE: Vertragsnummer (components.schemas.BuildingSavingPlanEquity.properties.contractNumber).
EN: Contract number (components.schemas.BuildingSavingPlanEquity.properties.contractNumber).
'
amount:
$ref: '#/components/schemas/EuroAmount'
BaseFinancingVenture:
type: object
description: 'DE: Vermögenswerte, welche (operativ) in die Finanzierung aufgenommen werden sollen.
EN: Operational (venture) assets used in the financing process.
'
required:
- reason
- mortgageProperty
properties:
reason:
$ref: '#/components/schemas/FinancingApplicationReason'
mortgageProperty:
description: 'DE: Referenz zum Beleihungsobjekt/Finanzierungsobjekt auf das sich das Finanzierungsvorhaben bezieht.
EN: Reference to the financing process related asset / property.
'
$ref: '#/components/schemas/EstateRef'
mainApplicant:
description: 'DE: Referenz zum Hauptantragssteller auf den sich das Finanzierungsvorhaben bezieht.
EN: Reference to the financing process related main applicant.
'
$ref: '#/components/schemas/ApplicantIdRef'
collateralMortgageProperties:
$ref: '#/components/schemas/CollateralMortgageProperties'
additionalApplicants:
$ref: '#/components/schemas/AdditionalApplicants'
investEquity:
$ref: '#/components/schemas/InvestEquity'
assignmentForSecurity:
$ref: '#/components/schemas/AssignmentForSecurity'
utilization:
$ref: '#/components/schemas/Utilization'
discriminator:
propertyName: reason
TemporaryResidencePermit:
type: object
required:
- expiryDate
- blueCard
properties:
expiryDate:
description: "DE: Ablaufdatum einer befristeten Aufenthaltserlaubnis (nur wenn eine befristete Aufenthaltserlaubnis vorliegt)
\nEN: expiry date of the residence permit (only if residence permit is temporary)\n"
$ref: '#/components/schemas/ISODate'
blueCard:
type: boolean
description: "DE: hat die Person eine \"Blue-Card\"
\nEN: does the person have a \"Blue-Card\"\n"
BasementDetailKey:
type: string
description: 'DE: Details zum Keller (nicht abschließende Aufzählung), z.B DEVELOPED=voll_unterkellert, PARTIALY_DEVELOPED=teil_unterkellert, NONE=nicht_unterkellert.
EN: Open ended enum contains basement details, possible values are DEVELOPED, PARTIALY_DEVELOPED, NONE.
'
example: DEVELOPED
x-extensible-enum:
- DEVELOPED
- PARTIALLY_DEVELOPED
- NONE
- OTHER
CompanyName:
type: object
properties:
name:
type: string
RentalIncomeItem:
type: object
required:
- estate
- rent
description: 'DE: Mieteinnahmen aus einem bestimmten Objekt.
EN: The rental income for a specific real estate.
'
properties:
rent:
$ref: '#/components/schemas/PeriodicalEuroAmount'
estate:
description: 'DE: Referenz zum Mietobjekt.
EN: Reference to the Estate which the rent is associated with.
'
$ref: '#/components/schemas/EstateRef'
ExistingMortgageDebt:
type: object
required:
- estate
description: 'DE: Bestehende Hypothek auf die Immobilie.
EN: Existing mortgage of the property.
'
allOf:
- $ref: '#/components/schemas/BaseExistingLoanDebt'
properties:
estate:
description: 'DE: Referenz zu dem Darlehen gehörenden Immobilie.
EN: Reference to the Estate which this Loan is associated with.
'
$ref: '#/components/schemas/EstateRef'
amount:
description: 'DE: Ursprünglicher Darlehenbetrag.
EN: Original debt amount.
'
$ref: '#/components/schemas/EuroAmount'
debitor:
$ref: '#/components/schemas/Debitor'
payoutDate:
description: 'DE: Datum der Vollauszahlung.
EN: Date of full payment.
'
$ref: '#/components/schemas/ISODate'
contractNumber:
description: 'DE: Darlehensnummer.
EN: Loan number.
'
type: string
promotionalLoan:
description: 'DE: Flag ob es sich um einen Förderdarlehen handelt.
EN: Flag indicates whether promotional loan is used.
'
type: boolean
nullable: true
interestFixDate:
description: 'DE: Ablauf Sollzinsbindung.
EN: Expiry of fixed interest rate.
'
$ref: '#/components/schemas/ISODate'
forward:
$ref: '#/components/schemas/ForwardExistingMortgage'
residualDebt:
description: 'DE: Vrs. Restschuld zum Zinsanpassungstermin.
EN: Current remaining debt.
'
$ref: '#/components/schemas/EuroAmount'
collateral:
description: 'DE: Beleihung.
EN: Collateral.
'
type: string
repay:
description: 'DE: Gewünschte Ablösung des Darlehens.
EN: Repayment of the loan desired.
'
type: boolean
nullable: true
propertyRegisterMortgageRef:
description: 'DE: Referenz zur Laufenden Nummer aus der dritten Abteilung des Grundbuchblattes.
EN: Reference to the serial number in land register from the third section of the land register sheet.
'
type: string
interestRate:
description: 'DE: Nominalzins (Sollzins)
EN: Nominal interest rate
'
$ref: '#/components/schemas/PeriodicalPercentage'
debitInterestCommitment:
$ref: '#/components/schemas/Duration'
expectedEndOfTheTerm:
$ref: '#/components/schemas/ISODate'
rankingInTheLandRegister:
type: string
BonusIncome:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Boni/Tantiemen.
EN: Additional periodical bonus income.
'
type: object
properties:
abroad:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Auslandseinsatz.
EN: Additional periodical income through assignment abroad.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
performance:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Prämien/ Leistungszulage.
EN: Additional periodical income through bonuses / performance allowances.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
profitSharing:
description: 'DE: Zusätzliches regelmäßiges Einkommen durch Tantieme/ Bonus.
EN: Additional periodical income through royalty / bonus.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
Building:
type: object
description: 'DE: Information über das Gebäude.
EN: Information about the building.
'
properties:
construction:
$ref: '#/components/schemas/Construction'
yearOfConstruction:
description: 'DE: Baujahr.
EN: Year of construction.
'
$ref: '#/components/schemas/Year'
lift:
description: 'DE: Vorhandener Aufzug.
EN: Existing elevator.
'
type: boolean
nullable: true
stories:
description: 'DE: Anzahl der Vollgeschosse (ohne Keller/Dachboden).
EN: Number of floors (without basement/attic).
'
type: integer
format: int32
buildingVolume:
description: 'DE: Umbauter Raum.
EN: Enclosed space.
'
$ref: '#/components/schemas/CubicMeter'
prefabrication:
$ref: '#/components/schemas/Prefabrication'
prefabCertified:
type: boolean
nullable: true
description: 'DE: Gütesiegel.
EN: quality seal.
'
energyEfficiency:
$ref: '#/components/schemas/EnergyEfficiency'
BaseFinancingDetails:
description: 'DE: Detailierte Information über das Finanzierungvorhaben.
EN: Detailed information about the financing process.
'
type: object
required:
- type
properties:
type:
type: string
x-extensible-enum:
- OWN
- FOREIGN
payoutDate:
description: 'DE: Auszahlungsdatum.
EN: Payout date.
'
$ref: '#/components/schemas/ISODate'
desiredDecisionDate:
description: 'DE: gewünschte Entscheidungsdatum.
EN: desired decision date.
'
$ref: '#/components/schemas/ISODate'
amortisationStartDate:
description: 'DE: Tilgungsbeginn.
EN: Start of amortisation.
'
$ref: '#/components/schemas/ISODate'
loanQuota:
$ref: '#/components/schemas/LoanQuota'
numberOfPayments:
type: integer
format: int32
description: 'DE: Anzahl Auszahlungen
EN: Number of payments
'
discriminator:
propertyName: type
RawEuroAmount:
description: 'DE: Euro Betrag als Zahl.
EN: Euro amount as number
'
type: object
required:
- value
properties:
value:
description: 'DE: Betrag.
EN: Value.
'
type: number
SuspendedRepaymentProductType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/SuspendedRepaymentProductTypeKey'
RealEstatePropertyConditionKey:
type: string
description: 'DE: Zustand des Gebäudes (nicht abschließende Aufzählung), z.B. IN_TOTAL_RENOVATION_NEED, IN_EXTENSIVE_MODERNISATION_NEED, IN_RENOVATION_NEED, IN_MODERNISATION_NEED, WELL_KEPT, AS_NEW.
EN: open ended enum contains general condition of the real estate, possible values are IN_TOTAL_RENOVATION_NEED, IN_EXTENSIVE_MODERNISATION_NEED, IN_RENOVATION_NEED, IN_MODERNISATION_NEED, WELL_KEPT, AS_NEW
'
example: IN_RENOVATION_NEED
x-extensible-enum:
- IN_TOTAL_RENOVATION_NEED
- IN_EXTENSIVE_MODERNISATION_NEED
- IN_RENOVATION_NEED
- IN_MODERNISATION_NEED
- WELL_KEPT
- AS_NEW
- OTHER
Employment:
type: object
description: 'DE: Informationen über das Beschäftigungsverhältnis des Antragstellers.
EN: Information regarding employment data.
'
allOf:
- $ref: '#/components/schemas/BaseOccupation'
properties:
jobInformation:
$ref: '#/components/schemas/JobInformation'
contractLimitation:
$ref: '#/components/schemas/ContractLimitation'
probation:
$ref: '#/components/schemas/JobProbation'
parentalLeave:
$ref: '#/components/schemas/ParentalLeave'
shortTimeWork:
$ref: '#/components/schemas/ShortTimeWork'
RegisterCover:
description: 'DE: Grundbuchdaten.
EN: General information about the land register sheet.
'
type: object
properties:
registerCourt:
description: 'DE: Amtsgericht.
EN: Land registry/local court.
'
type: string
registerCity:
description: 'DE: Grundbuchbezirk.
EN: City of land register.
'
type: string
registerVolume:
description: 'DE: Nummer des Bandes.
EN: Number of the volume of the land register.
'
type: string
registerPage:
description: 'DE: Nummer des Blattes.
EN: Page in the land register.
'
type: string
areaNeedingMeasurement:
description: "DE: geschätzte Größe der zu vermessenden Teilfläche.
\nEN: estimated size of the area needing measurement\n"
$ref: '#/components/schemas/SquareMeter'
Year:
type: object
title: Year
nullable: true
description: 'DE: Ein Jahr nach ISO-8601-Kalendersystem. EN: A year in the ISO-8601 calendar system.
'
required:
- value
properties:
value:
type: string
description: 'DE: Das Jahr. EN: The year.
'
pattern: ^\d{4}$
example: '2019'
HouseUtilityUnitGroupsBreakdown:
type: object
properties:
groups:
type: array
items:
$ref: '#/components/schemas/HouseUtilityUnitGroup'
Households:
type: object
description: 'A wrapper Type to hold a set of households associated with the financing application.
'
properties:
_href:
x-skip-camel-case-check: true
$ref: '#/components/schemas/ResourceRef'
embedded:
$ref: '#/components/schemas/HouseholdsQuery'
HouseUtilityRentedUnitGroup:
type: object
allOf:
- $ref: '#/components/schemas/BaseHouseUtilityUnitGroup'
properties:
rentDetails:
$ref: '#/components/schemas/HouseRentedUnitDetails'
Consultation:
readOnly: true
type: object
description: 'DE: Informationen über die Beratung und dazugehörige Empfehlungen.
EN: Information about the involved parties in the consultation phase and the associated recommendations.
'
required:
- broker
properties:
advisory:
$ref: '#/components/schemas/AdvisoryDetails'
broker:
deprecated: true
x-replaced-with: advisory.broker
description: 'DE: Daten des Vermittlers.
EN: Information about the main Broker (Interhp, Prohyp, MLP Hyp or Prohyp-WhiteLabel-Partner).
'
$ref: '#/components/schemas/Advisor'
subBroker:
deprecated: true
x-replaced-with: advisory.subBrokers
description: 'DE: Untervermittler des Antrags.
EN: Sub advisor.
'
$ref: '#/components/schemas/Advisor'
informers:
type: array
deprecated: true
x-replaced-with: advisory.clientAdvisor
description: 'DE: Daten des Zuträgers.
EN: Information about the involved informer.
'
items:
$ref: '#/components/schemas/Informer'
recommendation:
$ref: '#/components/schemas/Recommendation'
brokerageOrganization:
type: string
deprecated: true
x-replaced-with: advisory.brokeragePlatform.platformIdentifier
description: 'DE: Beratungsunternehmenidentifikator - Vermittlernummer.
EN: Advisor company identifier
'
BrokeragePlatform:
type: object
required:
- company
properties:
company:
$ref: '#/components/schemas/OrganizationCompany'
platformIdentifier:
$ref: '#/components/schemas/BrokeragePlatformIdentifier'
FinancialStanding:
oneOf:
- $ref: '#/components/schemas/FinancialEquity'
- $ref: '#/components/schemas/FinancialDebt'
- $ref: '#/components/schemas/Income'
- $ref: '#/components/schemas/Expense'
discriminator:
propertyName: type
mapping:
EQUITY: '#/components/schemas/FinancialEquity'
DEBT: '#/components/schemas/FinancialDebt'
INCOME: '#/components/schemas/Income'
EXPENSE: '#/components/schemas/Expense'
HouseholdCalculationCommandExpenses:
type: object
required:
- valuation
- entries
properties:
value:
description: Der vom Kunden eingetragene Wert
$ref: '#/components/schemas/PeriodicalRawEuroAmount'
valuation:
description: Der von der Bank angesetzte Wert
$ref: '#/components/schemas/PeriodicalRawEuroAmount'
entries:
type: array
items:
$ref: '#/components/schemas/HouseholdCalculationCommandEntry'
BaseMainProduct:
type: object
description: 'DE: Information zum Hauptdarlehensprodukt.
EN: Main loan product information.
'
required:
- product
properties:
product:
description: 'DE: Typ des Hauptdarlehensproduktes.
EN: Main loan product type.
'
$ref: '#/components/schemas/MainProductType'
productName:
description: 'DE: Name des Hauptdarlehensproduktes.
EN: Main loan product name.
'
type: string
discriminator:
propertyName: product
FinancingOfferStatus:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/FinancingOfferStatusKey'
RealEstateEquity:
type: object
required:
- total
description: 'DE: Eigenkapital durch Immobilienvermögen.
EN: Real estate equity.
'
properties:
total:
description: 'DE: Weiteres Immobilienvermögen (Marktwert).
EN: Other real estate assets (market value).
'
$ref: '#/components/schemas/EuroAmount'
guarantee:
description: 'DE: Sicherungsabtretung von Immobilienvermögen.
EN: Other realestate for assignment for security.
@deprecated: Use FinancingVenture.assignmentForSecurity.realEstateAssignedForSecurity instead.
'
deprecated: true
$ref: '#/components/schemas/EuroAmount'
items:
type: array
items:
$ref: '#/components/schemas/RealEstateEquityItem'
description:
type: string
SpecialPropertyType:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/SpecialPropertyTypeKey'
Applicant:
type: object
description: 'DE: Detaillierte Informationen des Antragstellers.
EN: Detailed information about the applicant.
'
required:
- id
- person
properties:
id:
description: 'DE: Id des Antragsstellers.
EN: Id of the applicant.
'
$ref: '#/components/schemas/ApplicantId'
person:
description: 'DE: Personendaten des Antragsstellers.
EN: Personal data of the applicant.
'
$ref: '#/components/schemas/Person'
contact:
description: 'DE: Kontaktdaten des Antragsstellers.
EN: Contact information about the applicant.
'
$ref: '#/components/schemas/Contact'
address:
description: 'DE: Derzeitige Adresse des Antragstellers.
EN: Current address of the applicant.
'
$ref: '#/components/schemas/Address'
previousAddress:
deprecated: true
description: '@deprecated: use the field livingAddresses instead.
DE: Voranschrift.
EN: Previous address of the applicant
'
$ref: '#/components/schemas/Address'
livingAddresses:
type: array
description: 'DE: Liste Addressen mit Angaben zum Zeitraum, an denen die Person in den letzten Jahren gewohnt hat. Die aktuelle Adresse ist ebenfalls enthalten.
EN: List of addresses the person has lived in over the last years. The current address is also included.
'
items:
$ref: '#/components/schemas/LivingAddress'
nationalities:
type: array
description: 'DE: Nationalitäten des Antragstellers.
EN: Nationalities of the applicant.
'
items:
$ref: '#/components/schemas/Nationality'
maritalStatus:
description: 'DE: Familienstand des Antragstellers.
EN: Marital status of the applicant.
'
$ref: '#/components/schemas/MaritalStatus'
maritalPropertyStatus:
description: 'DE: Beschreibung des ehelichen Güterstandes vom Antragsteller.
EN: Matrimonial property of the applicant.
'
$ref: '#/components/schemas/MaritalPropertyStatus'
creditWorthiness:
description: 'DE: Informationen über die Kreditwürdigkeit des Antragstellers.
EN: Information regarding credit worthiness of the applicant.
'
$ref: '#/components/schemas/CreditWorthiness'
occupationalActivity:
deprecated: true
description: '@Deprecated: this only contains one of possible multiple occupations. Please see ''occupations'' for a complete list. DE: Informationen über die derzeitige Erwerbstätigkeiten des Antragsstellers.
EN: Information about the current occupation of the applicant.
'
$ref: '#/components/schemas/Occupation'
occupations:
type: array
description: 'DE: Informationen über alle derzeitigen Erwerbstätigkeiten des Antragsstellers.
EN: Information about all current occupations of the applicant.
'
items:
$ref: '#/components/schemas/Occupation'
taxId:
type: string
description: 'DE: Steueridentifikationsnummer des Antragstellers.
EN: Tax identification number.
'
passportID:
x-skip-camel-case-check: true
type: string
example: CY887232L
description: 'DE: Ausweis Identifikationsnummer.
EN: Id of passport.
'
bankAccount:
description: 'DE: Daten zum Bankaccount des Antragsstellers.
EN: Applicant''s bank details.
'
$ref: '#/components/schemas/BankAccount'
financialStandings:
description: 'DE: Link um die Daten zur finanziellen Situation des Antragsstellers abzurufen.
EN: A link to retrieve all information about financing situation for a specific applicant.
'
$ref: '#/components/schemas/ResourceRef'
temporaryResidencePermit:
description: 'DE: Informationen falls die Aufenthaltserlaubnis befristet ist.
EN: Information if the residence permit is temporary.
'
$ref: '#/components/schemas/TemporaryResidencePermit'
unionInfo:
$ref: '#/components/schemas/UnionInfo'
mortgageExperience:
description: 'DE: Hat die Person schon einmal eine Immobilie finanziert? (true = ja, false = nein, null = keine Angabe)
EN: indication, whether the person has taken up a mortgage before (true; false; null = no information)
'
type: boolean
nullable: true
children:
type: array
nullable: false
description: "DE: Unterhaltspflichtige Kinder der Person. Wenn gemeinsame Kinder mit einem weiteren Antragssteller existieren, werden diese nur einmal aufgeführt.
\nEN: Children of the person that are obligation to pay alimony. If there are common children with one of the additional applicants, they will only be listed once.\n"
items:
$ref: '#/components/schemas/Child'
additionalInfos:
description: 'DE: Zusätzliche Details für den Antragsteller (Schlüssel-Werte Paar).
EN: Additional applicant details (key-value pairs).
'
type: array
items:
$ref: '#/components/schemas/AdditionalInfo'
EstateAcquisitionCosts:
type: object
description: 'DE: Kosten für den Erwerb der Immobilie.
EN: Estate costs when purchasing a property.
'
properties:
brokerage:
description: 'DE: Maklercourtage.
EN: Broker costs.
'
$ref: '#/components/schemas/EuroAmount'
costsNotary:
description: 'DE: Notar-/ Grundbuchkosten
EN: Notary costs.
'
$ref: '#/components/schemas/EuroAmount'
purchaseTax:
description: 'DE: Grunderwerbsteuer.
EN: Purchase tax.
'
$ref: '#/components/schemas/EuroAmount'
NeighbourhoodKey:
type: string
description: 'DE: Umgebung (nicht abschließende Aufzählung), z.B. RESIDENTIAL=reines_Wohngebiet, COMMERCIAL=ueberwiegend_Gewerbegebiet, MIXED=Mischgebiet, INDUSTRIAL=Industriegebiet, OUTSIDE=Einzellage_außerhalb_des_Ortes.
EN: Open ended enum contains neighbourhood details, possible values are RESIDENTIAL, COMMERCIAL, MIXED, INDUSTRIAL, OUTSIDE .
'
example: RESIDENTIAL
x-extensible-enum:
- RESIDENTIAL
- COMMERCIAL
- MIXED
- INDUSTRIAL
- OUTSIDE
- OTHER
Nationality:
type: object
required:
- country
- type
properties:
country:
description: 'DE: Staatsangehörigkeit des Antragstellers.
EN: Country of the nationality.
'
$ref: '#/components/schemas/CountryCode'
type:
$ref: '#/components/schemas/NationalityType'
EstateAdditionalLoanUsage:
type: object
required:
- key
properties:
key:
$ref: '#/components/schemas/EstateAdditionalLoanUsageKey'
SpecialRealEstateCharacteristics:
oneOf:
- $ref: '#/components/schemas/SpecialHouseCharacteristics'
- $ref: '#/components/schemas/DefaultSpecialRealEstateCharacteristics'
discriminator:
propertyName: type
mapping:
HOUSE: '#/components/schemas/SpecialHouseCharacteristics'
DEFAULT: '#/components/schemas/DefaultSpecialRealEstateCharacteristics'
PeriodicalEuroAmount:
description: 'DE: Euro Betrag in einem bestimmten Zeitraum.
EN: Euro amount for a specific period.
'
type: object
required:
- amount
- cycle
properties:
amount:
$ref: '#/components/schemas/EuroAmount'
cycle:
$ref: '#/components/schemas/Cycle'
InterestRate:
description: 'DE: Information über den Zins.
EN: Information about the interest rate.
'
type: object
properties:
nominal:
description: 'DE: Nominalzins (Sollzins) in Prozent
EN: Nominal interest rate percent per period.
'
$ref: '#/components/schemas/PeriodicalPercentage'
effective:
description: 'DE: Effektivzins in Prozent.
EN: Effective interest rate percent per period.
'
$ref: '#/components/schemas/PeriodicalPercentage'
SavingsPlanBurden:
type: object
properties:
savingsBurden:
description: 'DE: Sparrate.
EN: Periodical saving rate.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
additionalSavings:
description: 'DE: Zusätzlicher Sparbeitrag.
EN: Additional savings.
'
$ref: '#/components/schemas/EuroAmount'
numberOfSavingsBurdens:
description: 'DE: Anzahl zu zahlender Sparraten.
EN: Number of to be paid saving rates.
'
type: integer
format: int32
payedRates:
description: 'DE: Sparbeiträge insgesamt.
EN: The sum of the rates payed in the savings phase.
'
$ref: '#/components/schemas/EuroAmount'
specialPayments:
type: array
description: 'DE: Sonderzahlungen.
EN: Special payments.
'
items:
$ref: '#/components/schemas/SavingsPlanBurdenSpecialPayment'
PeriodicalRawEuroAmount:
description: 'DE: Euro Betrag in einem bestimmten Zeitraum.
EN: Euro amount for a specific period.
'
type: object
required:
- amount
- cycle
properties:
amount:
$ref: '#/components/schemas/RawEuroAmount'
cycle:
$ref: '#/components/schemas/Cycle'
KfwPromotionLoan:
description: 'DE: Information zum Kfw-Darlehen.
EN: Information about the KFW promotion loan.
'
type: object
allOf:
- $ref: '#/components/schemas/BaseLoan'
properties:
program:
$ref: '#/components/schemas/KfwProgram'
annuityDetails:
$ref: '#/components/schemas/AnnuityDetails'
reservations:
description: "DE: Sammlung von KFW-Darlehensreservierungen.
\n EN: Collection of KFW loan reservations.\n"
type: array
items:
$ref: '#/components/schemas/KfwReservationInfo'
additionalInfo:
$ref: '#/components/schemas/KfwLoanAdditionalInfo'
OtherIncome:
type: object
required:
- other
description: 'DE: Anderes (zusätzliches) regelmäßiges Einkommen.
EN: Other periodical income.
'
properties:
other:
$ref: '#/components/schemas/PeriodicalEuroAmount'
external:
$ref: '#/components/schemas/PeriodicalEuroAmount'
description:
type: string
SelfEmploymentIncomeItem:
type: object
description: 'DE: Informationen zum Einkommen aus selbständiger Tätigkeit für ein Jahr
EN: Describes the self employment income information for a year.
'
properties:
year:
type: integer
format: int32
description: 'DE: Jahr (lfd/Vorjahr/Vorvorjahr).
EN: The balance year.
'
netProfit:
description: 'DE: Persönlicher Nachsteuergewinn.
EN: Personal after-tax profit.
'
$ref: '#/components/schemas/EuroAmount'
surplus:
description: 'DE: Überschuss/Fehlbetrag.
EN: Excess / shortfall.
'
$ref: '#/components/schemas/EuroAmount'
deficit:
$ref: '#/components/schemas/EuroAmount'
taxes:
description: 'DE: Steuern.
EN: Deducted Taxes.
'
$ref: '#/components/schemas/EuroAmount'
Advisor:
readOnly: true
type: object
description: 'DE: Informationen über den Berater.
EN: Information about the advisor.
'
required:
- advisorCompany
properties:
userId:
$ref: '#/components/schemas/UserId'
companyId:
$ref: '#/components/schemas/CompanyId'
advisorCompany:
description: 'DE: Die an der Vermittlung beteiligte Firma..
EN: Company involved in the brokerage process.
'
$ref: '#/components/schemas/CompanyAdvisor'
responsiblePersons:
description: 'DE: Für die Vermittlung zuständige Personen.
EN: Persons responsible for the brokerage.
'
type: array
items:
$ref: '#/components/schemas/ResponsiblePerson'
DefaultRealEstateRating:
allOf:
- $ref: '#/components/schemas/BaseRealEstateRating'
properties:
localPriceDetails:
$ref: '#/components/schemas/LocalPriceDetails'
SavingPlanTariff:
type: object
required:
- id
- name
- loanPartner
properties:
id:
description: 'DE: ID der gewählter Bauspartarif.
EN: ID of the chosen savings plan tariff.
'
example: KF.195
type: string
name:
description: 'DE: Name der gewählter Bauspartarif.
EN: Name of the chosen savings plan tariff.
'
example: D/Komfort 1,95%
type: string
loanPartner:
deprecated: true
description: Can be removed after the changes to the loan partner structure have been released
$ref: '#/components/schemas/LoanPartnerProcessingUnit'
loanPartnerId:
$ref: '#/components/schemas/CompanyId'
variantPrice:
description: 'DE: einmalig Variantepreis.
EN: costs for variant.
'
$ref: '#/components/schemas/EuroAmount'
magazineCosts:
description: 'DE: !!!.
EN: The potential costs of the saving plan magazines.
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
BaseCreditWorthiness:
type: object
description: 'DE: Informationen über die Kreditwürdigkeit des Antragstellers (zum Beispiel Schufa Score).
EN: Information regarding credit worthiness (like Schufa-Score).
'
required:
- type
properties:
type:
type: string
description: 'DE: Art der Ermittlung der Kreditwürdigkeitsbeurteilung (nicht abschließende Aufzählung, zum Beispiel: Schufa).
EN: Open ended enum contains possible Worthiness Ratings, possible values are SCHUFA.
'
x-extensible-enum:
- SCHUFA
discriminator:
propertyName: type
RegularMainProduct:
allOf:
- $ref: '#/components/schemas/BaseMainProduct'
FinancialEquity:
type: object
required:
- type
description: 'DE: Informationen zum Eigenkapital vor Beginn des Finanzierungsprozesses.
EN: Financial equity information before the financing process.
'
allOf:
- $ref: '#/components/schemas/BaseFinancialStanding'
properties:
cash:
description: 'DE: Bankguthaben (vor der Finanzierung).
EN: Bank balance (before financing).
'
$ref: '#/components/schemas/EuroAmount'
stock:
description: 'DE: Informationen über Wertpapiere (vor der Finanzierung).
EN: Stock assets information (before financing).
'
$ref: '#/components/schemas/EuroAmount'
mortgageSaving:
description: 'DE: gesamt bisher angesparte Bausparguthaben (vor der Finanzierung).
EN: total up to date saved home savings plans (before financing).
'
$ref: '#/components/schemas/EuroAmount'
mortgageSavingPlansDetails:
type: array
items:
$ref: '#/components/schemas/BuildingSavingPlanEquity'
insurance:
description: 'DE: Informationen zu Rückkaufwerte von Lebens-/Pensionsversicherungen.
EN: Surrender value life-/pension insurance equity.
'
$ref: '#/components/schemas/EuroAmount'
realEstate:
$ref: '#/components/schemas/RealEstateEquity'
other:
$ref: '#/components/schemas/OtherEquity'
KfwProgramKey:
type: string
description: 'DE: KFW-Förderprogramm (nicht abschließende Aufzählung), z.B. Wohneigen, Wohn159, Energie153-40, Energie151, Energie152, Energie167.
EN: Open ended enum contains possible programs for Kfw, i.e. Wohneigen, Wohn159, Energie153-40, Energie151, Energie152, Energie167.
'
example: Wohneigen
x-extensible-enum:
- Wohneigen
- Wohn159
- Energie153-40
- Energie151
- Energie152
- Energie167
- Eff261
- Einzel262
- KFNWohnselbst297
- KFNWohnselbstQNG297
- KFNWohnkapital298
- KFNWohnkapitalQNG298
- WEPFamilien300
- WEPFamilienQNG300
- WEPFamilienJKA308
- EMKreditPlus
- EMKredit
- KNN296WOHN
Basement:
type: object
description: 'DE: Information über den Keller.
EN: Information about building basement.
'
properties:
basementDetail:
$ref: '#/components/schemas/BasementDetail'
basementExtensionForResidentialUse:
$ref: '#/components/schemas/BasementExtensionForResidentialUse'
basementArea:
description: 'DE: Kellerfläche.
EN: Basement space.
'
$ref: '#/components/schemas/SquareMeter'
BaseRateDetails:
type: object
required:
- rateType
properties:
rateType:
$ref: '#/components/schemas/RateDetailsType'
interestRate:
$ref: '#/components/schemas/InterestRate'
payment:
$ref: '#/components/schemas/RegularPayment'
residualDebt:
description: 'DE: Restschuld nach Ablauf der Sollzinsbindung.
EN: Remaining debt at the end of fixed interest maturity.
'
$ref: '#/components/schemas/EuroAmount'
discriminator:
propertyName: rateType
ExternalEstateId:
description: 'DE: ID des vorhandenen Objekts im System
EN: ID of existing object in the system
'
type: object
required:
- value
properties:
value:
type: string
Violation:
description: 'DE: Ein Verstoss gegen die Schnittstellenspezifikation. EN: A violation against the API schema.
'
type: object
title: Violation
properties:
field:
type: string
description: 'DE: Bezeichner des problematischen Felds. EN: Name of the problematic field.
'
example: address.city.numberOfInhabitants
message:
type: string
description: 'DE: Beschreibung des Verstosses. EN: Description of the violation.
'
example: Must be greater than or equal to 0.
Paging:
type: object
description: 'Cursor-based pagination to improve performance and minimize networks traffic, Pagination is enforced for operations
that potentially could return a large collection of items.
'
properties:
cursor:
$ref: '#/components/schemas/Cursor'
previous:
type: string
format: uri
description: 'A Hyperlink that will return the previous page of data. If not included, this is the first page of data.
'
next:
type: string
format: uri
description: 'A Hyperlink that will return the next page of data. If not included, this is the last page of data.
> The Absence of *next* hyperlink indicates that a query reached the end of the available result.
'
first:
type: string
format: uri
description: 'A Hyperlink that will return the first page of data.
'
last:
type: string
format: uri
description: 'A Hyperlink that will return the last page of data at this point of time.
'
self:
type: string
format: uri
description: 'A Hyperlink that will return the current page of data.
'
JobInformation:
type: object
description: 'DE: Stellenbeschreibung der Tätigkeit.
EN: Detailed information about the specified job.
'
properties:
jobDescription:
type: string
description: 'DE: Stellenbeschreibung der Tätigkeit.
EN: The description/name of the job.
'
businessLine:
description: 'DE: Branche des Auftraggebers/Arbeitgebers.
EN: Business line of the employer.
'
$ref: '#/components/schemas/BusinessLine'
employer:
type: string
description: 'DE: Name des Auftraggebers/Arbeitgebers.
EN: The name of the employer.
'
startDate:
description: 'DE: Beginn des Beschäftigungsverhältnis.
EN: Start date of the employment.
'
$ref: '#/components/schemas/ISODate'
FinancingVentureConstruction:
description: 'DE: Information über das Finanzierungsvorhaben beim Bau einer Immobilie.
EN: Information about the financing venture when building the property.
'
required:
- financingNeed
- financingDetails
allOf:
- $ref: '#/components/schemas/BaseFinancingVenture'
properties:
financingNeed:
$ref: '#/components/schemas/ForeignEstateFinancingNeed'
financingDetails:
$ref: '#/components/schemas/FinancingDetails'
constructionStartDate:
description: 'DE: Beginn der Bauarbeiten an der Immobilie.
EN: Start date of the construction work on the property.
'
$ref: '#/components/schemas/ISODate'
SquareMeter:
type: object
description: 'DE: Angabe in Quadratmetern.
EN: Specification in square metres.
'
required:
- value
properties:
value:
type: number
format: double
HouseholdCalculationCommandEntry:
type: object
required:
- name
- valuation
properties:
name:
type: string
description: Name des Eintrages
hints:
type: array
description: Liste an Hinweißen
items:
type: string
values:
type: array
description: Der vom Kunden eingetragene Wert
items:
$ref: '#/components/schemas/PeriodicalRawEuroAmount'
valuation:
description: Der von der Bank angesetzte Wert
$ref: '#/components/schemas/PeriodicalRawEuroAmount'
loanId:
$ref: '#/components/schemas/LoanId'
VariableIncome:
type: object
description: 'DE: Regelmäßige variable Einkünfte (netto).
EN: Regular variable gross income.
'
required:
- amount
properties:
amount:
$ref: '#/components/schemas/PeriodicalEuroAmount'
breakdown:
$ref: '#/components/schemas/VariableIncomeBreakdown'
FurnishingKey:
type: string
description: 'DE: Beurteilung der Austattung der Immobilie (nicht abschließende Aufzählung). Einflussfaktoren sind z. B. verwendete Böden, etc.
EN: Open ended enum contains property configuration (furnishing) details, possible values are (SIMPLE, GOOD, VERY_GOOD).
'
example: SIMPLE
x-extensible-enum:
- SIMPLE
- GOOD
- VERY_GOOD
- OTHER
Expense:
type: object
required:
- type
description: 'DE: Ein Untertyp von "Financial Standing", welcher alle Informationen zu den `Ausgaben` beinhaltet.
EN: A specific financial standing type holds all information related to periodical `Expenses` aspects.
'
allOf:
- $ref: '#/components/schemas/BaseFinancialStanding'
properties:
housing:
$ref: '#/components/schemas/HousingExpense'
insurance:
$ref: '#/components/schemas/InsuranceExpense'
alimony:
$ref: '#/components/schemas/AlimonyExpense'
existingLoans:
$ref: '#/components/schemas/ExistingLoanExpenses'
other:
$ref: '#/components/schemas/OtherExpense'
ParentalAllowanceInfo:
type: object
description: 'DE: Informationen über Elterngeld.
EN: Informations regarding parental/child-raising allowance.
'
required:
- parentalAllowance
properties:
parentalAllowance:
$ref: '#/components/schemas/PeriodicalEuroAmount'
endDate:
$ref: '#/components/schemas/ISODate'
FinancingOfferStatusKey:
description: 'DE: Status des Finanzierungsangebots.
EN: Financing offer status.
'
type: string
x-extensible-enum:
- ACCEPTED
- REJECTED
EuroAmountPerSquareMeter:
description: 'DE: Euro Betrag pro Quadratmeter.
EN: Euro amount per square meter.
'
type: object
required:
- amount
properties:
amount:
$ref: '#/components/schemas/EuroAmount'
BaseInterestMaturity:
type: object
required:
- type
properties:
type:
$ref: '#/components/schemas/InterestMaturityType'
discriminator:
propertyName: type
PeriodicalSavingsEntry:
type: object
allOf:
- $ref: '#/components/schemas/EntryPeriod'
- $ref: '#/components/schemas/SavingsEntry'
LoanToValueRatioLoanBreakdown:
title: LoanToValueRatioLoanBreakdown
type: object
required:
- valuation
properties:
valuation:
description: Die Summe der Gesamtwerte, die die Bank ansetzt in Euro
$ref: '#/components/schemas/RawEuroAmount'
entries:
type: array
items:
$ref: '#/components/schemas/LoanToValueRatioEntry'
FinancingStructures:
description: 'DE: Information über die Struktur der Finanzierung.
EN: Information about the financing structure.
'
type: object
properties:
amount:
description: 'DE: Darlehensbetrag.
EN: Loan amount.
'
$ref: '#/components/schemas/EuroAmount'
interest:
description: 'DE: Effektiver Zins pro Periode.
EN: Effective interest per period.
'
$ref: '#/components/schemas/PeriodicalPercentage'
burden:
description: 'DE: Periodische Rate (z.B. monatliche Rate).
EN: Periodical payment amount (e.g. rate per month).
'
$ref: '#/components/schemas/PeriodicalEuroAmount'
components:
description: 'DE: Tranchen die eine Finanzierungsangebot abbilden.
EN: Tranches that are associated with financing offer.
'
type: array
items:
$ref: '#/components/schemas/Loan'
minItems: 1
residualDebtProtections:
description: 'DE: Restschuldabsicherungen.
EN: Residual debt protections.
'
$ref: '#/components/schemas/ResidualDebtProtections'
calculations:
description: 'DE: Kalkulationen für die Kreditentscheidung
EN: Calculations for the credit decision
'
type: array
items:
$ref: '#/components/schemas/ProductCalculation'
repaymentPlans:
description: 'DE: Tilgungsplan
EN: Repayment plan
'
$ref: '#/components/schemas/RepaymentPlans'
parameters:
debt-id:
name: debtId
in: path
required: true
schema:
type: string
description: Id for the requested existing mortgage.
informer-id:
name: informerId
in: path
required: true
schema:
type: string
description: Id of the requested informer
financing-application-id:
name: financingApplicationId
in: path
required: true
schema:
type: string
description: Id of the financing application
applicant-id:
name: applicantId
in: path
required: true
schema:
type: string
description: Id for the requested applicant.
embed:
name: embed
in: query
style: form
required: false
schema:
type: boolean
description: 'Flag to expand or embed sub-resources in the response resource.
By default is set to `FALSE` where only a **ref** to the sub-resources will be returned. By set it to `TRUE` the sub-resources content will be embedded in the response which might affect the payload size'
financial-standing-id:
name: financialStandingId
in: path
required: true
schema:
type: string
description: Id for the requested financial standing.
estate-id:
name: estateId
in: path
required: true
schema:
type: string
description: Id for the requested estate.
financial-standing-filter:
name: type
in: query
required: false
schema:
type: string
enum:
- debt
- equity
- income
- expense
description: query parameter to restrict financial state associated with the provided type.
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT