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