openapi: 3.0.2 info: title: Interhyp Submission commands submissions 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: submissions description: provides endpoints for submission resources associated with a specific financing partner paths: /submissions: get: summary: Delivers all active submissions for a specific financing partner. description: 'This endpoint gives a possibility to retrieve information about active submissions that belong to a specific financing partner filtered by submission date using `since` query parameter. **Tip:** A submission is considered to be active, when it has not been revoked. *By Default*, we will return the first *20* matching records. However, this is not a hard limitation! `limit` parameter can be used to tell the API how many records you want to receive at once *(max 50)*.
To get further matching records, `after` or `before` parameters can be used to tell the API the start of each page using specified cursor.
To navigate through the query result, a reference to the following navigations are included in the response *(next, previous)*. ' operationId: getSubmissions tags: - submissions parameters: - $ref: '#/components/parameters/since' - $ref: '#/components/parameters/until' - $ref: '#/components/parameters/sbms-limit' - $ref: '#/components/parameters/cursor-after' - $ref: '#/components/parameters/cursor-before' - $ref: '#/components/parameters/sbms-sort' responses: '200': description: A paged array of submissions matching the provided criteria. 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' '500': description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' /submissions/{submissionId}: get: summary: Get a specific submission description: "This endpoint gives a possibility to retrieve information about a specific submission using it's id.\nA submission (Kreditantrag) holds all the information in order to help the financing partners during credit decision phase.\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: getSubmissionById tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' - $ref: '#/components/parameters/embed' responses: '200': description: Requested submission is returned content: application/json: schema: $ref: '#/components/schemas/Submission' '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' /submissions/{submissionId}/calculations/{calculationType}: get: summary: Get calculation data description: "Delivers calculation basics for specified calculation type.\nCalculation type options:\n - CONDITION (Konditionskalkulation)\n\n - HOUSEHOLD (HH-Rechnung)\n\n - LENDING_VALUE (Beleihungswert)" operationId: getSubmissionCalculationByType tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' - $ref: '#/components/parameters/calculation-type' responses: '200': description: Requested calculation data is returned content: application/json: schema: $ref: '#/components/schemas/Calculations' '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' /submissions/{submissionId}/commands: post: summary: Modify an existing submission. description: 'This endpoint gives a possibility to modify an existing submission asynchronously by creating a command to perform this operation, as a result a *command id* shall be returned. In order to follow up the command execution result, a call to `/v2/commands` endpoint could be made providing the *command id* ' operationId: modifySubmission tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ModifySubmissionCommand' responses: '201': description: Reference to the created resource. headers: Location: schema: type: string description: 'DE: Link zu einer spezifischen Ressource
EN: Link to retrieve a specific resource ' example: http://some-domain/some/link/to/somewhere content: application/json: schema: $ref: '#/components/schemas/CommandId' '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' '500': description: Unexpected Error content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' /submissions/{submissionId}/credit-loans/{creditLoanId}: get: summary: Get a specific credit loan description: 'Delivers detailed information about a specific credit loan associated with this submission. A Credit Loan represents specific financing structure component.' operationId: getSubmissionCreditLoanById tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' - $ref: '#/components/parameters/credit-loan-id' responses: '200': description: Requested Credit Loan Details are returned content: application/json: schema: $ref: '#/components/schemas/CreditLoan' '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' /submissions/{submissionId}/financing-application: get: summary: Get a submitted financing application description: "Delivers information about existing financing application associated with a specific submission.\n\nA Financing Application holds all the information which have been collected from the Applicants during the consultation phase. Holds information regarding\n - Applicants Personal details\n\n - Applicants Credit Worthiness\n\n - Estates involved in the financing process\n\n - Venture\n\n - Consultation Unit\n\n - Offer\n\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 financing-application sub-resources (i.e /v2/financing-applications/{applicationId}/estates)\n\n - initiate the call with request parameter `embed` set to *TRUE* (i.e /v2/submissions/{submissionId}/financing-application?embed=true)\n\nPlease refer to *Expansion* section for more details.\n" operationId: getSubmissionFinancingApplication tags: - submissions parameters: - $ref: '#/components/parameters/submission-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' /submissions/{submissionId}/handover-documents: get: summary: Get handover documents description: "Delivers metadata regarding the system generated reports for a specific submission.\nHandover reports including but not limited to\n - Übergabeprotokoll (Handover protocol)\n\n - Provideranschreiben (Provider cover letter)\n\n - Überarbeiteter Antrag (Revised application)\n\n - Kalkulation (Condition calculation)\n\n - HH-Rechnung (Household calculation)" operationId: getHandoverDocuments tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' responses: '200': description: Requested meta data are returned content: application/json: schema: $ref: '#/components/schemas/CreditDecisionDocumentMetaData' example: '{ "documents": [ { "submissionId": "de-20230227-en9lndd-ev3y1", "documentId": "63a86906-ad38-45bc-a10e-c1d0b8978af5", "documentType": "CONDITION_CALCULATION", "documentName": "condition calculation", "createdAt": "2019-12-29T10:22:50Z", "href": { "href": "https://api.interhyp.de/submission/v2/submissions/de-20230424-krczwx6-5sves/handover/reports/NDMzOTk4Mi1QUk9WSURFUl9DT1ZFUl9MRVRURVItUHJvdmlkZXJhbnNjaHJlaWJlbg==" } } ] }' '400': description: Error indicates missing or wrong request parameters. content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' example: '{ "timestamp": "2023-03-07T17:49:39.995Z", "title": "Bad Request", "status": 400, "traceId": "64077933c36912de13fb3cd7ae0c00c8", "instance": "/v2/submissions/de-20230314-0rztcss-55vcy/status" }' '401': description: Error indicates no access to the required resource. content: application/json: schema: $ref: '#/components/schemas/OAuthProblem' example: '{ "error": "invalid token", "error_description": "Access token expired", }' '403': description: Error indicates insufficient privileges to create/access the resource. content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' example: '{ "timestamp": "2023-03-14T10:00:00.995Z", "title": "Forbidden", "status": 403, "traceId": "64077933c36912de13fb3cd7ae0c00c8", "instance": "/v2/submissions/de-20230314-0rztcss-55vcy/status" }' '500': description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' example: '{ "timestamp": "2023-03-14T10:00:00.995Z", "title": "Internal Server Error", "status": 500, "traceId": "64077933c36912de13fb3cd7ae0c00c8", "instance": "/v2/submissions/de-20230314-0rztcss-55vcy/status" }' /submissions/{submissionId}/handover/reports: get: summary: Get handover reports deprecated: true description: "@deprecated: Please use instead endpoint: '/v2/submissions/{submissionId}/handover-documents:'\nDelivers metadata regarding the system generated reports for a specific submission.\nHandover reports including but not limited to\n - Übergabeprotokoll\n\n - Provideranschreiben\n\n - Überarbeiteter Antrag\n\n - Kalkulation\n\n - HH-Rechnung\n\nHandover reports are associated with a specific financing structure context (i.e `Main` or `Nachrang` component)." operationId: getSubmissionHandoverReports tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' responses: '200': description: Requested handover reports are returned content: application/json: schema: $ref: '#/components/schemas/HandoverReports' '202': description: Payload is being prepared, try again later headers: Retry-After: schema: type: integer description: payload is expected to be ready after the specified amout of seconds '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' /submissions/{submissionId}/handover/reports/{name}: get: summary: Get a specific handover report as `PDF` description: Delivers detailed information about a specific handover report as `PDF` document. operationId: getSubmissionHandoverReportByName tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' - $ref: '#/components/parameters/handover-report-name' responses: '200': description: Requested handover report is returned content: application/pdf: schema: $ref: '#/components/schemas/HandoverReportBinary' '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' /submissions/{submissionId}/overview: get: summary: Get the overview for a submission description: Delivers an overview for the requested submission. operationId: getSubmissionOverview tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' responses: '200': description: Requested overview of the submission is returned content: application/json: schema: $ref: '#/components/schemas/SubmissionOverview' '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' /submissions/{submissionId}/status: get: summary: Get current status of specified submission description: Delivers information about current status of a specific submission operationId: getSubmissionStatusById tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' responses: '200': description: Current status of the requested submission is returned content: application/json: schema: $ref: '#/components/schemas/SubmissionStatus' example: '{ "type": "SUBMITTED", "remark": "Submission was submitted", "changedOn": "2023-03-14T10:22:50Z" }' '400': description: Error indicates missing or wrong request parameters. content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' example: '{ "timestamp": "2023-03-07T17:49:39.995Z", "title": "Bad Request", "status": 400, "traceId": "64077933c36912de13fb3cd7ae0c00c8", "instance": "/v2/submissions/de-20230314-0rztcss-55vcy/status" }' '401': description: Error indicates no access to the required resource. content: application/json: schema: $ref: '#/components/schemas/OAuthProblem' example: '{ "error": "invalid token", "error_description": "Access token expired", }' '403': description: Error indicates insufficient privileges to create/access the resource. content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' example: '{ "timestamp": "2023-03-14T10:00:00.995Z", "title": "Forbidden", "status": 403, "traceId": "64077933c36912de13fb3cd7ae0c00c8", "instance": "/v2/submissions/de-20230314-0rztcss-55vcy/status" }' '500': description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' example: '{ "timestamp": "2023-03-14T10:00:00.995Z", "title": "Internal Server Error", "status": 500, "traceId": "64077933c36912de13fb3cd7ae0c00c8", "instance": "/v2/submissions/de-20230314-0rztcss-55vcy/status" }' /submissions/{submissionId}/uploaded-documents/{documentId}/content: get: summary: Get a specific submission document as `PDF` description: Delivers detailed information about a specific submission document as `PDF` document. operationId: getSubmissionDocumentById tags: - submissions parameters: - $ref: '#/components/parameters/submission-id' - $ref: '#/components/parameters/document-id' responses: '200': description: Requested submission document is returned content: application/pdf: schema: $ref: '#/components/schemas/SubmissionDocumentBinary' '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 document 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' 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' 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' PauseReason: type: object required: - key properties: key: $ref: '#/components/schemas/PauseReasonKey' 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 RefuseSignContractCommand: description: command to indicate that a customer refused to sign a contract. type: object required: - reason allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string reason: $ref: '#/components/schemas/RefuseSignContractReason' CreditLoanItem: type: object description: 'Holds information regarding a specific submission credit loan. Further details will be delivered in the embedded property if specified. Please refer to *Expansion* section for more details. ' properties: id: $ref: '#/components/schemas/CreditLoanId' _href: x-skip-camel-case-check: true $ref: '#/components/schemas/ResourceRef' types: type: array description: 'DE: Art des Darlehens.
EN: set of loan types associated with this credit loan. ' items: $ref: '#/components/schemas/LoanType' minItems: 1 embedded: $ref: '#/components/schemas/CreditLoan' 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' 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 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' SubmissionDefaultStatus: allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' 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 LoanPartnerProcessingInfo: description: 'DE: Einheit des Kreditgebers, welche die Einreichung bearbeitet und aktueller (Kreditsach-)Bearbeiter.
EN: Processing Unit and current processor of the loan partner. ' type: object deprecated: true properties: unit: $ref: '#/components/schemas/LoanPartnerProcessingUnit' processor: $ref: '#/components/schemas/LoanPartnerProcessor' 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' InterestRateUpdate: oneOf: - $ref: '#/components/schemas/AnnuityInterestRateUpdate' - $ref: '#/components/schemas/BuildingSavingPlanInterestRateUpdate' discriminator: propertyName: rateUpdateType mapping: ANNUITY: '#/components/schemas/AnnuityInterestRateUpdate' BUILDING_SAVING_PLAN: '#/components/schemas/BuildingSavingPlanInterestRateUpdate' 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. ProcessorName: description: 'DE: Username, Vor- und Nachname des (Kredit-)Bearbeiters.
EN: Username, first- and lastname of the loan partner processor. ' required: - userName properties: userName: type: string firstName: type: string lastName: type: string CreditDecisionDocumentMetaData: type: object deprecated: true properties: documents: type: array items: $ref: '#/components/schemas/DocumentMetaData' 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 OriginInfo: type: object required: - client - externalId description: 'DE: Enthält die Information über Datenquelle und Daten-Identifikator aus dem externen System.
EN: Contains information about Data source and data identifier in the external system. ' properties: client: $ref: '#/components/schemas/Client' externalId: $ref: '#/components/schemas/ExternalId' intentId: $ref: '#/components/schemas/IntentId' 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' InitialSubmissionEstimate: description: 'DE: Voraussichtliches Entscheidungsdatum.
EN: Estimated decision date. ' type: object properties: createdAt: $ref: '#/components/schemas/ISODateTime' ExternalProcessingReason: type: string description: 'EN: Open ended enum contains possible reasons for external processing (EXTERNAL_EXPERT_ASSESSMENT, INTERNAL_EXPERT_ASSESSMENT, DECISION_INTERNAL_UNIT, CONTRACT_CREATION, FORWARD_FINAL_DECISION, REJECT_NOTICE, WAITING_FOR_ORIGINAL_CONTRACT, OTHER) DE: Mögliche Gruende fur das Warten auf externe Faktoren (EXTERNAL_EXPERT_ASSESSMENT=Externes Gutachten, INTERNAL_EXPERT_ASSESSMENT=Internes Gutachten, DECISION_INTERNAL_UNIT=Entscheidung Marktfolge, CONTRACT_CREATION=Vertragserstellung, FORWARD_FINAL_DECISION=Weitergabe finale Genehmigung, REJECT_NOTICE=Ablehnungsankündigung, WAITING_FOR_ORIGINAL_CONTRACT=Warten auf Vertragsoriginal, OTHER=Nicht aufgeführter Grund) ' example: OTHER x-extensible-enum: - EXTERNAL_EXPERT_ASSESSMENT - INTERNAL_EXPERT_ASSESSMENT - DECISION_INTERNAL_UNIT - CONTRACT_CREATION - FORWARD_FINAL_DECISION - REJECT_NOTICE - WAITING_FOR_ORIGINAL_CONTRACT - OTHER 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' RejectReason: type: object required: - key properties: key: $ref: '#/components/schemas/RejectReasonKey' CalculationDetail: description: 'DE: Detailierte Information über einen Eintrag in der Kalkulation.
EN: Detailed information about single entry in the calculation. ' type: object properties: index: type: integer description: 'DE: Reihenfolge Index innerhalb der Kalkulationdetails.
EN: Order index within calculation details. ' category: $ref: '#/components/schemas/DetailType' name: type: string description: 'DE: Name des Wertes.
EN: Entry name. ' description: type: string description: 'DE: Beschreibung des Wertes.
EN: Entry description. ' userInputValue: type: string description: 'DE: Von user eingetragene Wert.
EN: User input value. ' calculatedValue: type: string description: 'DE: Berechnete Wert.
EN: Calculated value. ' hints: type: array description: 'DE: Hinweise zum
EN: Collection of calculation hints. ' items: type: string 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' LoanPartnerProcessorCommandTrigger: type: object allOf: - $ref: '#/components/schemas/BaseCommandTrigger' properties: processingUnit: deprecated: true description: This is deprecated and will be removed as soon as the services can handle the new field. $ref: '#/components/schemas/LoanPartnerProcessingInfo' processingUnitId: $ref: '#/components/schemas/CompanyId' processorId: $ref: '#/components/schemas/ProcessorId' HousingSituation: type: object required: - key properties: key: $ref: '#/components/schemas/HousingSituationKey' ArchiveSubmissionCommand: description: Mark a submission as archived. type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' 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' 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' 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 RejectSubmissionCounterOfferCommand: type: object description: command to reject a counter offer. required: - counterOfferId - reason - remark allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: counterOfferId: $ref: '#/components/schemas/SubmissionCounterOfferId' reason: $ref: '#/components/schemas/RejectSubmissionCounterOfferReason' remark: type: string 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' CreditLoanId: type: object description: 'DE: Id der Finanzierungsstruktur.
EN: Credit Loan identifier. ' required: - value properties: value: type: string 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' CalculationItem: type: object properties: context: x-is-plural: true type: array 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).. ' items: $ref: '#/components/schemas/LoanType' calculation: $ref: '#/components/schemas/Calculation' 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 BaseInterestRateUpdate: type: object required: - rateUpdateType properties: rateUpdateType: type: string x-extensible-enum: - ANNUITY - BUILDING_SAVING_PLAN discriminator: propertyName: rateUpdateType 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 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 CounterOfferMainLoan: description: 'DE: Information zum Gegenangebot Hauptdarlehen.
EN: Information about the counter offer main loan. ' type: object required: - type - rateDetails allOf: - $ref: '#/components/schemas/BaseCounterOfferLoan' properties: rateDetails: description: 'DE: Detailinformation zu den Raten.
EN: Detailed information about the rates. ' $ref: '#/components/schemas/CounterOfferRateDetails' HandoverReport: type: object description: "DE: Metadaten zur den Einreichungsunterlagen.
\nEN: Metadata regarding the system generated reports for a specific submission.\nHandover reports including but not limited to:\n - Übergabeprotokoll\n\n - Provideranschreiben\n\n - Überarbeiteter Antrag\n\n - Kalkulation\n\n - HH-Rechnung\n" required: - name - description - createdAt properties: name: type: string description: 'DE: Bezeichnung der Einreichungsunterlage.
EN: Name of the handover report. ' description: type: string description: 'DE: Kurze Beschreibung der Einreichungsunterlage.
EN: Short description of the handover report. ' createdAt: $ref: '#/components/schemas/ISODateTime' context: type: array description: 'DE: Einreichungsunterlage nach Art des Darlehens.
EN: A set of financing structure contexts, which are associated with this handover report (i.e `Main` or `Nachrang` component).. ' items: $ref: '#/components/schemas/LoanType' x-is-plural: true content: description: 'DE: Link zur Unterlage als `PDF` Document.
EN: Link to retrieve the content of a specific handover report as `PDF` document. ' $ref: '#/components/schemas/ResourceRef' AdditionalField: description: 'DE: Zusätzliche Feldinformationen.
EN: Additional field info. ' type: object required: - id - name - value properties: id: type: string name: type: string value: type: string _href: x-skip-camel-case-check: true $ref: '#/components/schemas/ResourceRef' 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' UpdateSubmissionLoanContractNumberCommand: description: Update the contract number of a loan of a submission. type: object required: - contracts allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: contracts: type: array minItems: 1 items: $ref: '#/components/schemas/ContractInfo' createdBy: description: 'DE: Optionale Informationen über den Auslöser der Aktion.
EN: Optional information about the trigger of the command. ' $ref: '#/components/schemas/PersonName' 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' SubmissionCounterOfferId: type: object required: - value description: 'DE: ID vom Gegenangebot. EN: Id of the counter offer. ' properties: value: type: string RefuseSignContractReasonKey: type: string description: 'DE: Grund für die Ablehnung des Vertrags, mögliche Werte sind NOTARY_APPOINTMENT_UNAVAILABLE=Notartermin kann nicht rechtzeitig stattfinden, OBJECT_UNAVAILABLE=Objekt hat sich zerschlagen, VENTURE_UNAVAILABLE=Vorhaben hat sich zerschlagen, CUSTOMER_DECIDED_DIFFERENT_PROVIDER=Kunde hat sich für einen anderen Finanzierungspartner entschieden, NO_CUSTOMER_INTEREST=Kunde hat sich nicht mehr gemeldet, OTHER=Nicht aufgeführter Grund EN: Reason for refusing contract, possible values are NOTARY_APPOINTMENT_UNAVAILABLE, OBJECT_UNAVAILABLE, VENTURE_UNAVAILABLE, CUSTOMER_DECIDED_DIFFERENT_PROVIDER, NO_CUSTOMER_INTEREST, OTHER ' x-extensible-enum: - NOTARY_APPOINTMENT_UNAVAILABLE - OBJECT_UNAVAILABLE - VENTURE_UNAVAILABLE - CUSTOMER_DECIDED_DIFFERENT_PROVIDER - NO_CUSTOMER_INTEREST - OTHER 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 SubmissionRevokedStatus: type: object description: 'EN: Status containing information about revocation ' required: - type - revocation allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: reason: type: string description: 'EN: Revocation reason ' reasonDescription: type: string description: 'EN: Short description of the revocation reason ' reasonType: $ref: '#/components/schemas/SubmissionRevokedReasonType' revokedOn: $ref: '#/components/schemas/ISODate' 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' PreSubmissionCheckId: type: object description: 'An Id refers to a specific pre submission check resource. ' properties: value: type: string 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 IntentId: type: object description: 'DE: IntentId aus dem externen System.
EN: IntentId in the external system. ' properties: value: type: string 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' SubmissionStatus: oneOf: - $ref: '#/components/schemas/SubmissionRejectedStatus' - $ref: '#/components/schemas/ContractDeliveredStatus' - $ref: '#/components/schemas/ContractSignedStatus' - $ref: '#/components/schemas/SubmissionDefaultStatus' - $ref: '#/components/schemas/SubmissionAwaitExternalProcessingStatus' - $ref: '#/components/schemas/SubmissionRevokedStatus' - $ref: '#/components/schemas/SubmissionCounterOfferCreatedStatus' - $ref: '#/components/schemas/SubmissionCounterOfferRejectedStatus' - $ref: '#/components/schemas/SubmissionCounterOfferRevokedStatus' - $ref: '#/components/schemas/SubmissionProcessingPausedStatus' - $ref: '#/components/schemas/SubmissionContractSignRefusedStatus' - $ref: '#/components/schemas/SubmissionContractCanceledStatus' - $ref: '#/components/schemas/ConfirmedSubmissionStatus' discriminator: propertyName: type mapping: REJECTED: '#/components/schemas/SubmissionRejectedStatus' CONTRACT_DELIVERED: '#/components/schemas/ContractDeliveredStatus' CONTRACT_SIGNED: '#/components/schemas/ContractSignedStatus' INWORK: '#/components/schemas/SubmissionDefaultStatus' APPROVED: '#/components/schemas/SubmissionDefaultStatus' REJECTION_REVOKED: '#/components/schemas/SubmissionDefaultStatus' AWAIT_EXTERNAL_PROCESSING: '#/components/schemas/SubmissionAwaitExternalProcessingStatus' CREATED: '#/components/schemas/SubmissionDefaultStatus' SUBMITTED: '#/components/schemas/SubmissionDefaultStatus' AVAILABLE_FOR_DECISION: '#/components/schemas/SubmissionDefaultStatus' REVOKED: '#/components/schemas/SubmissionRevokedStatus' COUNTER_OFFER_CREATED: '#/components/schemas/SubmissionCounterOfferCreatedStatus' COUNTER_OFFER_ACCEPTED: '#/components/schemas/SubmissionDefaultStatus' COUNTER_OFFER_REJECTED: '#/components/schemas/SubmissionCounterOfferRejectedStatus' COUNTER_OFFER_REVOKED: '#/components/schemas/SubmissionCounterOfferRevokedStatus' PROCESSING_PAUSED: '#/components/schemas/SubmissionProcessingPausedStatus' CONTRACT_SIGN_REFUSED: '#/components/schemas/SubmissionContractSignRefusedStatus' CONTRACT_CANCELED: '#/components/schemas/SubmissionContractCanceledStatus' CONFIRMED: '#/components/schemas/ConfirmedSubmissionStatus' REJECTED_AND_CLOSED: '#/components/schemas/SubmissionDefaultStatus' SubmissionCounterOfferRejectedStatus: type: object description: 'EN: Status containing information about counteroffer that was rejected ' required: - type - reason allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: reason: $ref: '#/components/schemas/RejectSubmissionCounterOfferReason' 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' CounterOfferLoan: oneOf: - $ref: '#/components/schemas/CounterOfferMainLoan' - $ref: '#/components/schemas/CounterOfferKfwLoan' - $ref: '#/components/schemas/CounterOfferAuxiliaryLoan' discriminator: propertyName: type mapping: MAIN_LOAN: '#/components/schemas/CounterOfferMainLoan' KFW_PROMOTION_LOAN: '#/components/schemas/CounterOfferKfwLoan' AUXILIARY_LOAN: '#/components/schemas/CounterOfferAuxiliaryLoan' PropertyRegisterInventoryId: type: object required: - id description: 'DE: Laufende Nummer eines Grundstücks/Eigentum.
EN: Serial number of the property. ' properties: id: type: string ProcessorDetails: description: details of loan partner processor type: object required: - loanPartnerId properties: name: $ref: '#/components/schemas/PersonName' loanPartnerId: $ref: '#/components/schemas/CompanyId' contact: $ref: '#/components/schemas/Contact' Handover: type: object description: 'DE: Beratunsprotokoll und Empfehlung des Beraters.
EN: Advisor Handover notes and recommendations. ' properties: hints: type: string description: 'DE: Hinweise des Beraters.
EN: Hints provided by the financing advisor. ' documents: description: Link to retrieve list of handover documents $ref: '#/components/schemas/ResourceRef' example: https://api.interhyp.de/submission/v2/submissions/de-20230424-krczwx6-5sves/handover-documents handoverReports: deprecated: true description: '@deprecated: Please use field documents to get list of handover documents ' type: array items: $ref: '#/components/schemas/HandoverReport' 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' AdditionalFields: description: 'DE: Zusätzliche Felder.
EN: Additional fields. ' type: object properties: fields: type: array items: $ref: '#/components/schemas/AdditionalField' PreInquiryId: type: object description: 'DE: ID des Voranfrage.
EN: PreInquiry identifier. ' properties: value: type: string 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 BaseCounterOfferRateDetails: type: object required: - rateType - interestRate - amortisationRate properties: rateType: $ref: '#/components/schemas/RateDetailsType' interestRate: $ref: '#/components/schemas/InterestRate' discriminator: propertyName: rateType LendingValueCalculation: description: 'DE: Information zu der Kalkulation
EN: Information about the calculation. ' type: object allOf: - $ref: '#/components/schemas/BaseCalculation' properties: lendingValue: $ref: '#/components/schemas/LoanQuota' details: type: array items: $ref: '#/components/schemas/CalculationDetail' 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 ExternalId: type: object description: 'DE: Daten-Identifikator aus dem externen System.
EN: Data identifier in the external system. ' properties: value: type: string SubmissionContractSignRefusedStatus: type: object description: 'EN: Status containing information about refusing to sign the contract ' required: - type - refuseReason allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: refuseReason: $ref: '#/components/schemas/RefuseSignContractReason' RevokeSubmissionCommand: description: This command is only used for internal purposes! type: object required: - reason allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: reason: $ref: '#/components/schemas/SubmissionRevokedReason' remark: type: string 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' SubmissionDataViolationSeverity: type: object required: - key properties: key: $ref: '#/components/schemas/SubmissionDataViolationSeverityKey' 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 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 CancelContractReasonKey: type: string description: 'DE: Grund für die Vertragskündigung, mögliche Werte sind NOTARY_APPOINTMENT_UNAVAILABLE=Notartermin kann nicht rechtzeitig stattfinden, OBJECT_UNAVAILABLE=Objekt hat sich zerschlagen, VENTURE_UNAVAILABLE=Vorhaben hat sich zerschlagen, CUSTOMER_DECIDED_DIFFERENT_PROVIDER=Kunde hat sich für einen anderen Finanzierungspartner entschieden, NO_CUSTOMER_INTEREST=Kunde hat sich nicht mehr gemeldet, OTHER=Nicht aufgeführter Grund EN: Reason for canceling contract, possible values are NOTARY_APPOINTMENT_UNAVAILABLE, OBJECT_UNAVAILABLE, VENTURE_UNAVAILABLE, CUSTOMER_DECIDED_DIFFERENT_PROVIDER, NO_CUSTOMER_INTEREST, OTHER ' x-extensible-enum: - NOTARY_APPOINTMENT_UNAVAILABLE - OBJECT_UNAVAILABLE - VENTURE_UNAVAILABLE - CUSTOMER_DECIDED_DIFFERENT_PROVIDER - NO_CUSTOMER_INTEREST - OTHER 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 AdvisorCommandTrigger: writeOnly: true type: object required: - advisor allOf: - $ref: '#/components/schemas/BaseCommandTrigger' properties: advisor: $ref: '#/components/schemas/Advisor' ConditionCalculation: description: 'DE: Information über Konditionskalkulation.
EN: Information about condition calculation. ' type: object allOf: - $ref: '#/components/schemas/BaseCalculation' properties: loan: $ref: '#/components/schemas/LoanConditionGeneralInfo' details: type: array items: $ref: '#/components/schemas/LoanConditionDetail' 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 ContractSignedStatus: type: object description: 'EN: Status containing information about signed contract ' required: - type allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: contractSignDate: $ref: '#/components/schemas/ISODate' contracts: type: array items: $ref: '#/components/schemas/ExtendedContractInfo' 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 RevokeSubmissionCounterOfferCommand: type: object description: command to revoke a counter offer. required: - counterOfferId - reason allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: counterOfferId: $ref: '#/components/schemas/SubmissionCounterOfferId' reason: $ref: '#/components/schemas/RevokeSubmissionCounterOfferReason' remark: type: string 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' PreInquiry: type: object properties: preInquiryId: $ref: '#/components/schemas/PreInquiryId' createdAt: $ref: '#/components/schemas/ISODateTime' status: $ref: '#/components/schemas/PreInquiryStatus' 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' BaseCounterOfferLoan: type: object description: 'DE: Information zum Gegenangebot Darlehen.
EN: Information about the counter offer loan. ' required: - id - type - amount - maturity - specialRepayment - commission properties: id: $ref: '#/components/schemas/LoanId' type: $ref: '#/components/schemas/LoanType' amount: description: 'DE: Darlehnsbetrag (per Tranche).
EN: Loan amount (for loan component). ' $ref: '#/components/schemas/EuroAmount' maturity: $ref: '#/components/schemas/InterestMaturity' specialRepayment: $ref: '#/components/schemas/SpecialRepayment' commission: $ref: '#/components/schemas/CommissionInfo' commitmentInterest: description: 'DE: Bereitstellungszins.
EN: Periodical commitment interest rate. ' $ref: '#/components/schemas/PeriodicalPercentage' discriminator: propertyName: type 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 CancelContractSubmissionCommand: description: command to cancel a signed contract of a submission on behalf of the customer. type: object required: - reason - cancellationDate allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: reason: $ref: '#/components/schemas/CancelContractReason' remark: type: string cancellationDate: $ref: '#/components/schemas/ISODate' ConfirmedSubmissionStatus: type: object description: 'EN: Status containing information about confirming the submission ' required: - confirmedAt - type allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: confirmedAt: $ref: '#/components/schemas/ISODateTime' 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. ' HandoverReports: type: object description: 'A wrapper Type to hold a set of handover reports references. ' required: - data properties: data: type: array items: $ref: '#/components/schemas/HandoverReport' LoanPartnerProcessor: description: 'DE: Der (Kredit-)Bearbeiter.
EN: The loan partner processor. ' required: - processorId - processorName properties: processorId: $ref: '#/components/schemas/LoanPartnerProcessorId' processorName: $ref: '#/components/schemas/LoanPartnerProcessorName' processorEmail: $ref: '#/components/schemas/LoanPartnerProcessorEmail' 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' DeliverContractSubmissionCommand: type: object description: command to hand over the contract after successful credit decision. required: - contracts - contractDeliveryDate allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string contracts: type: array minItems: 1 items: $ref: '#/components/schemas/ExtendedContractInfo' contractDeliveryDate: description: 'DE: Datum der Aushändigung des Vertrages.
EN: Contract delivery date. ' $ref: '#/components/schemas/ISODate' 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 ProductTypeKey: type: string description: 'DE: Art des Zusatzprodukten.
EN: Enum contains type of the additional product. ' example: BAU_SPAR x-extensible-enum: - A_FONDS - AU_AL - BH_HAFTPF - BAU_SPAR - BU - CONTAINER - DREAD_DIS - FONDS_HYP - FONDS_LV - FONDS_RV - FONDS_SPAR - GES_FOND - GIRO - GFV - GRUND - HAFTPFL - HAUSRAT - HYPO - BSCHUTZ - INVEST - VERK_LVRV - KAPITAL_LV - PENSIONK - PRIV_KRANK - CREDIT - RECHT - RENTEN - RES_DEB_INS - RISIKO_LV - RURUP_RIEST - SOLAR - TEDDY - UNFALL - BUI - PREPAY_HARD - PREPAY_RELO - PREPAY_DIV - OTHER RemainingDebtAtComponent: type: object required: - loanId - remainingDebt properties: loanId: $ref: '#/components/schemas/LoanId' remainingDebt: $ref: '#/components/schemas/RawEuroAmount' PreSubmissionCheckItem: description: Performed pre-submission check information type: object required: - preSubmissionCheckId properties: preSubmissionCheckId: $ref: '#/components/schemas/PreSubmissionCheckId' createdAt: $ref: '#/components/schemas/ISODateTime' 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 SubmissionTimeline: type: object description: 'DE: Zeitplan einer Einreichung. EN: Timeline of a submission. ' properties: predictedLoanPartnerDecisionDate: $ref: '#/components/schemas/PredictedLoanPartnerDecisionDate' 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. ' Submission: type: object description: 'DE: Ein Kreditantrag enthält alle relevanten Informationen für eine Kreditentscheidung.
EN: A submission holds all the information in order to help the financing partners during credit decision phase. ' required: - submissionId properties: submissionId: $ref: '#/components/schemas/SubmissionId' financingApplication: $ref: '#/components/schemas/FinancingApplicationItem' overview: $ref: '#/components/schemas/SubmissionOverviewItem' creditLoans: $ref: '#/components/schemas/CreditLoans' residualDebtProtections: $ref: '#/components/schemas/ResidualDebtProtections' originInfo: $ref: '#/components/schemas/OriginInfo' preInquires: $ref: '#/components/schemas/PreInquires' preSubmissionChecks: $ref: '#/components/schemas/PreSubmissionCheckItems' 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' CloseRejectedSubmissionCommand: description: command to close rejected submission if new active component was detected that matches with previously rejected component. type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string 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 ProcessorId: description: 'DE: ID des Sachearbeiters bei einem Kreditgeber. EN: Id of the loan partner processor. ' required: - value properties: value: type: string 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' SubmissionRevokedReason: type: object required: - key properties: key: $ref: '#/components/schemas/SubmissionRevokedReasonKey' 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' BaseCounterOfferSuspendedAmortizationCombinedProduct: type: object required: - product properties: product: $ref: '#/components/schemas/SuspendedRepaymentProductTypeKey' discriminator: propertyName: product SubmissionCounterOfferRevokedStatus: type: object description: 'EN: Status containing information about counteroffer that was revoked ' required: - type - reason allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: reason: $ref: '#/components/schemas/RevokeSubmissionCounterOfferReason' 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 SubmissionCounterOffer: type: object properties: id: $ref: '#/components/schemas/SubmissionCounterOfferId' offeredLoans: type: array items: $ref: '#/components/schemas/CreditLoan' validUntil: $ref: '#/components/schemas/ISODate' offerDate: $ref: '#/components/schemas/ISODate' 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' 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 SubmissionRevokedReasonType: type: string description: 'DE: Mögliche Gründe für einen Widerruf des Darlehensvertrags
EN: Possible reasons for revocation of the loan agreement ' example: TIME x-extensible-enum: - TIME - COND - DOCS - NO_OBJECT - MAIN - AUX - WRONG_BID - ERROR_USE - ERROR_TEC - TERMINATION - REALLOCATION - OTHER 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' ChangeLoanPartnerProcessingUnitCommand: description: command to change assigned loan partner processing unit type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: processingUnitId: deprecated: true description: This is deprecated and will be removed as soon as the services can handle the new field. $ref: '#/components/schemas/LoanPartnerProcessingUnitId' processingUnit: $ref: '#/components/schemas/ProcessingUnit' remark: type: string 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' ExtendedContractInfo: type: object description: 'DE: Vertragsnummer mit Referenznummer ID.
EN: Contract number and reference id pair with additional loan details. ' required: - contractNumber - loanType - referenceId properties: contractNumber: type: string description: 'DE: Darlehensnummer / Vertragsnummer.
EN: Loan number / contract number. ' referenceId: $ref: '#/components/schemas/ContractInfoReferenceId' loanType: $ref: '#/components/schemas/ContractInfoLoanType' loanDetails: $ref: '#/components/schemas/LoanDetails' ContractInfo: type: object description: 'DE: Vertragsnummer mit Referenznummer ID.
EN: Contract number and reference id pair. ' required: - contractNumber - loanType - referenceId properties: contractNumber: type: string description: 'DE: Darlehensnummer / Vertragsnummer.
EN: Loan number / contract number. ' referenceId: $ref: '#/components/schemas/ContractInfoReferenceId' loanType: $ref: '#/components/schemas/ContractInfoLoanType' Company: description: 'DE: Informationen zu einem Unternehmen. EN: Information of a company. ' required: - companyId properties: companyId: $ref: '#/components/schemas/CompanyId' name: readOnly: true $ref: '#/components/schemas/CompanyName' 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' SubmissionDataViolationSeverityKey: type: string x-extensible-enum: - INFO - WARN - ERROR 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' CounterOfferAuxiliaryLoan: description: 'DE: Information zum Gegenangebot Nachrangdarlehen.
EN: Information about the counter offer auxiliary loan. ' type: object required: - type - annuityDetails allOf: - $ref: '#/components/schemas/BaseCounterOfferLoan' properties: annuityDetails: $ref: '#/components/schemas/CounterOfferAnnuityRateDetails' PhoneReachability: type: object required: - key properties: key: $ref: '#/components/schemas/PhoneReachabilityKey' PauseReasonKey: type: string x-extensible-enum: - DOCUMENTS - INFOS - BY_CUSTOMER - ONHOLD - EXPERTISE - ORIG_CONTR - REJ_SOON - FIN_APPROV - MIN_DOCS - OTHER 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' CounterOfferKfwLoan: description: 'DE: Information zum Gegenangebot Kfw-Darlehen.
EN: Information about the counter offer KFW loan. ' type: object required: - type - program - annuityDetails allOf: - $ref: '#/components/schemas/BaseCounterOfferLoan' properties: program: $ref: '#/components/schemas/KfwProgram' annuityDetails: $ref: '#/components/schemas/CounterOfferAnnuityRateDetails' 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 SubmissionContractCanceledStatus: type: object description: 'EN: Status containing information about cancelling the contract ' required: - type - reason - cancellationDate allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: reason: $ref: '#/components/schemas/CancelContractReason' cancellationDate: $ref: '#/components/schemas/ISODate' 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' 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 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 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' 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' 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 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 ProcessingUnit: description: 'DE: Informationen zur Einheit des Kreditgebers, welche die Einreichung bearbeitet. EN: Id of the loan partner processing unit. ' required: - processingUnit properties: loanPartnerQueue: $ref: '#/components/schemas/LoanPartnerQueue' processingUnit: description: The current processing unit of a submission. If the processing unit is not provided while creating, the loan partner will be used as processing unit. $ref: '#/components/schemas/Company' 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' HouseholdCalculation: description: 'DE: Information zu der Haushalt Kalkulation
EN: Information about the household calculation. ' type: object allOf: - $ref: '#/components/schemas/BaseCalculation' properties: summary: $ref: '#/components/schemas/FinancialStandingSummary' details: type: array items: $ref: '#/components/schemas/CalculationDetail' financialBurden: type: array items: $ref: '#/components/schemas/FinancialBurdenDetail' x-is-plural: true 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' CounterOfferAnnuityRateDetails: type: object allOf: - $ref: '#/components/schemas/BaseCounterOfferRateDetails' properties: amortisationRate: description: 'DE: Tilgungsrate (Prozent pro Periode).
EN: Amortisation rate (percent per period). ' $ref: '#/components/schemas/PeriodicalPercentage' SavingsPlanBurdenSpecialPaymentPeriod: type: object required: - from - to properties: from: $ref: '#/components/schemas/ISODate' to: $ref: '#/components/schemas/ISODate' 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' 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' 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' CounterOfferRateDetails: oneOf: - $ref: '#/components/schemas/CounterOfferAnnuityRateDetails' - $ref: '#/components/schemas/CounterOfferSuspendedAmortizationRateDetails' discriminator: propertyName: rateType mapping: ANNUITY: '#/components/schemas/CounterOfferAnnuityRateDetails' SUSPENDED_AMORTIZATION: '#/components/schemas/CounterOfferSuspendedAmortizationRateDetails' 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' Processor: description: 'DE: Informationen zur Bearbeiter des Kreditgebers, welche die Einreichung bearbeitet. EN: The processor who is working on a submission. ' required: - processorId properties: processorId: $ref: '#/components/schemas/ProcessorId' processorName: readOnly: true $ref: '#/components/schemas/ProcessorName' SubmissionRejection: type: object required: - reasons properties: reasons: type: array minItems: 1 items: $ref: '#/components/schemas/RejectReason' remark: type: string 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 CreditLoans: type: object description: 'A wrapper Type to hold a set of submission credit loans. ' properties: data: type: array items: $ref: '#/components/schemas/CreditLoanItem' ApproveSubmissionCommand: description: command to approve a submission during credit decision phase providing information. type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string 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' FinancingApplicationRef: type: object description: 'A reference to a specific financing application resource. This reference consists of a link which leads directly to the resource and an Id which could be used to reconstruct the url. ' required: - id properties: _href: x-skip-camel-case-check: true $ref: '#/components/schemas/ResourceRef' id: $ref: '#/components/schemas/FinancingApplicationId' 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 ContractInfoReferenceId: type: object description: 'DE: Referenz zu einem Baustein, dessen Vertragsnummer aktualisiert werden soll. EN: Reference to a component whose contract number should be updated. ' properties: value: type: string 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 SystemCommandTrigger: type: object required: - name allOf: - $ref: '#/components/schemas/BaseCommandTrigger' properties: name: type: string description: type: string BaseSubmissionStatus: type: object description: 'EN: Basic submission status representation ' required: - type properties: type: $ref: '#/components/schemas/SubmissionStatusType' remark: description: short comment regarding the status type: string changedOn: description: timestamp as of the status has been set. $ref: '#/components/schemas/ISODateTime' discriminator: propertyName: type 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 BuildingSavingPlanInterestRateUpdate: description: details of building saving plan interest rate update type: object allOf: - $ref: '#/components/schemas/BaseInterestRateUpdate' properties: savingPhaseInterestRate: $ref: '#/components/schemas/SavingsPlanInterest' creditPhaseInterestRate: $ref: '#/components/schemas/InterestRate' 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' SubmissionDataViolation: description: a specific submission violation type: object required: - description properties: code: type: string description: type: string proposedSolution: type: string severity: $ref: '#/components/schemas/SubmissionDataViolationSeverity' ExternalProcessingDetail: type: object required: - reason properties: reason: $ref: '#/components/schemas/ExternalProcessingReason' 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' RejectSubmissionCounterOfferReason: type: object required: - key properties: key: $ref: '#/components/schemas/RejectSubmissionCounterOfferReasonKey' SubmissionCounterOfferCommandData: type: object required: - components - offerDate - remark properties: components: description: 'DE: Tranchen die ein Gegenangebot abbilden.
EN: Tranches that are associated with a counter offer. ' type: array items: $ref: '#/components/schemas/CounterOfferLoan' minItems: 1 validUntil: description: 'DE: Ablaufdatum des Angebots.
EN: Offer expiration date. ' $ref: '#/components/schemas/ISODateTime' offerDate: description: 'DE: Angebotsdatum.
EN: Offer creation date. ' $ref: '#/components/schemas/ISODate' remark: type: string ModernisationType: type: object required: - key properties: key: $ref: '#/components/schemas/ModernisationTypeKey' CounterOfferSuspendedAmortizationRateDetails: type: object allOf: - $ref: '#/components/schemas/BaseCounterOfferRateDetails' properties: combinedProduct: $ref: '#/components/schemas/CounterOfferSuspendedAmortizationCombinedProduct' 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 SubmissionAwaitExternalProcessingStatus: type: object description: 'EN: Status containing information about external processing ' required: - type allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: previousStatus: $ref: '#/components/schemas/SubmissionStatus' externalProcessing: $ref: '#/components/schemas/ExternalProcessing' StatSource: type: object required: - key properties: key: $ref: '#/components/schemas/StatSourceKey' LoanConditionGeneralInfo: description: 'DE: Allgemeine Information zu den Darlehen (Konditionskalkulation).
EN: General loan information (conditions calculation). ' type: object properties: loanAmount: description: 'DE: Gesamter Darlehnsbetrag.
EN: Total loan amount. ' $ref: '#/components/schemas/EuroAmount' loanQuota: description: 'DE: Darlehnsquote (Prozentsatz)
EN: Loan quota (percentage). ' $ref: '#/components/schemas/Percentage' mixedEffectiveRate: description: 'DE: Mischzins (effektiv).
EN: Mixed effective rate. ' $ref: '#/components/schemas/PeriodicalPercentage' baserateIssueDate: description: 'DE: Einstandsdatum.
EN: Base rate issue date. ' $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' paymentTime: $ref: '#/components/schemas/PaymentTime' 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' CounterOfferBuildingSavingLoan: description: "DE: Information zum Gegenangebot Bausparer.
\nEN: Information about the counter offer building saving loan.\n type: object\n" required: - amount - commission - creditPhase - savingsPhase allOf: - $ref: '#/components/schemas/BaseCounterOfferSuspendedAmortizationCombinedProduct' properties: amount: description: 'DE: Darlehnsbetrag (per Tranche).
EN: Loan amount (for loan component). ' $ref: '#/components/schemas/EuroAmount' commission: $ref: '#/components/schemas/CommissionInfo' creditPhase: $ref: '#/components/schemas/CounterOfferBuildingSavingLoanCreditPhase' savingsPhase: $ref: '#/components/schemas/CounterOfferBuildingSavingLoanSavingsPhase' 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' ContractDeliveredStatus: type: object description: 'EN: Status containing information about delivered contract ' required: - type allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: contractDeliverDate: $ref: '#/components/schemas/ISODate' contracts: type: array items: $ref: '#/components/schemas/ExtendedContractInfo' 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' SubmissionProcessingPausedStatus: type: object description: 'EN: Status containing information about pausing the processing ' required: - type - reason allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: previousStatus: $ref: '#/components/schemas/SubmissionStatus' reason: $ref: '#/components/schemas/PauseReason' dueDate: $ref: '#/components/schemas/ISODate' predictedDaysPost: type: integer format: int32 RevokeSubmissionRejectionCommand: description: command to revert a rejection of a submission during credit decision phase. type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string 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' RefuseSignContractReason: type: object required: - key properties: key: $ref: '#/components/schemas/RefuseSignContractReasonKey' AssignSubmissionLoanPartnerProcessorDetailsCommand: description: assign processing using details type: object required: - processor allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: processor: $ref: '#/components/schemas/ProcessorDetails' 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' StartProcessingSubmissionCommand: description: command to start the processing of a submission. type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string 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 RevokeSubmissionCounterOfferReasonKey: type: string description: 'DE: Grund für den Entzug, mögliche Werte sind COUNTER_OFFER_EXPIRED=Gegenangebot kann nicht mehr aufrechterhalten werden, READJUST_COUNTER_OFFER=Gegenangebot soll nach Rücksprache nochmal angepasst werden, COUNTER_OFFER_NOT_ACCEPTED=Gegenangebot wird nicht angenommen, OTHER=Nicht aufgeführter Grund EN: Reason for revocation, possible values are COUNTER_OFFER_EXPIRED, READJUST_COUNTER_OFFER, COUNTER_OFFER_NOT_ACCEPTED, OTHER ' example: OTHER x-extensible-enum: - COUNTER_OFFER_EXPIRED - READJUST_COUNTER_OFFER - COUNTER_OFFER_NOT_ACCEPTED - OTHER 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' PauseSubmissionProcessingCommand: description: command to pause processing of the submission type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string reason: $ref: '#/components/schemas/PauseReason' dueDate: $ref: '#/components/schemas/ISODate' 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 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' 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' HandoverReportBinary: type: string format: binary 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' 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' 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 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 DefaultUnionInfo: allOf: - $ref: '#/components/schemas/BaseUnionInfo' ResumeSubmissionProcessingCommand: description: command to resume submission processing type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string KfwCallType: type: object required: - key properties: key: $ref: '#/components/schemas/KfwCallTypeKey' CreateSubmissionCounterOfferCommand: type: object description: command to create a counter offer for a specific submission providing all needed information during credit decision phase. required: - data allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: data: $ref: '#/components/schemas/SubmissionCounterOfferCommandData' SubmissionCounterOfferCreatedStatus: type: object description: 'EN: Status containing information about counteroffer that was created ' required: - type - offer allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: offer: $ref: '#/components/schemas/SubmissionCounterOffer' 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' LoanConditionDetail: description: 'DE: Information über einzelnen Darlehen innerhalb des Konditionskalkulations.
EN: Information about single loan which is a part of condition calculation. ' type: object properties: loanId: $ref: '#/components/schemas/LoanId' loanType: $ref: '#/components/schemas/LoanType' amount: description: 'DE: Darlehensbetrag.
EN: Loan amount. ' $ref: '#/components/schemas/EuroAmount' payout: description: 'DE: Auszahlung (Prozent).
EN: Payout (percent). ' $ref: '#/components/schemas/Percentage' maturity: description: 'DE: Dauer der Sollzinsbindung.
EN: Duration of interest rate maturity. ' $ref: '#/components/schemas/Duration' initialAmortisationRate: description: 'DE: Initiale Tilgungsrate (Prozent).
EN: Initial amortisation rate (percent). ' $ref: '#/components/schemas/Percentage' additionalInfo: x-is-plural: true type: array description: 'DE: Information über einzelnen Eintrag innerhalb des Konditionskalkulation.
EN: Information about single entry within condition calculation. ' items: $ref: '#/components/schemas/AdditionalInfo' summary: $ref: '#/components/schemas/LoanConditionSummary' AnnuityInterestRateUpdate: description: details of annuity interest rate update type: object allOf: - $ref: '#/components/schemas/BaseInterestRateUpdate' properties: baseInterestRate: $ref: '#/components/schemas/InterestRate' amortizationRate: $ref: '#/components/schemas/PeriodicalPercentage' 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 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' 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})?$ VariableInterestMaturity: description: 'DE: Information über die variable Sollzinsbindung.
EN: Information about variable interest rate maturity. ' type: object required: - type allOf: - $ref: '#/components/schemas/BaseInterestMaturity' 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 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 PreSubmissionCheckItems: description: Collection of performed pre-submission checks type: object required: - preSubmissionChecks properties: preSubmissionChecks: type: array items: $ref: '#/components/schemas/PreSubmissionCheckItem' Calculation: oneOf: - $ref: '#/components/schemas/HouseholdCalculation' - $ref: '#/components/schemas/ConditionCalculation' - $ref: '#/components/schemas/LendingValueCalculation' discriminator: propertyName: type mapping: HOUSEHOLD: '#/components/schemas/HouseholdCalculation' CONDITION: '#/components/schemas/ConditionCalculation' LENDING_VALUE: '#/components/schemas/LendingValueCalculation' 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' AddSubmissionLogbookNoteCommand: description: command to add Logbook note for the submission type: object required: - comment - isVisibleForSales allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: comment: type: string isVisibleForSales: type: boolean 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' ContractInfoLoanType: description: 'DE: Type des Loans dessen Vertragsnummer aktualisiert werden soll.
EN: Type of loan where the contract number should be updated. ' type: string x-extensible-enum: - LOAN - SUSPENDED_AMORTIZATION_COMBINED_BUILDING_LOAN - RESIDUAL_DEBT_PROTECTION_BUILDING_SAVING_PLAN CommandTrigger: oneOf: - $ref: '#/components/schemas/AdvisorCommandTrigger' - $ref: '#/components/schemas/LoanPartnerProcessorCommandTrigger' - $ref: '#/components/schemas/SystemCommandTrigger' discriminator: propertyName: type mapping: ADVISOR: '#/components/schemas/AdvisorCommandTrigger' LOAN_PARTNER_PROCESSOR: '#/components/schemas/LoanPartnerProcessorCommandTrigger' SYSTEM: '#/components/schemas/SystemCommandTrigger' 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' CreditLoan: type: object description: 'DE: Informationen zur Finanzierungsstruktur.
EN: A Credit Loan represents specific financing structure component. ' properties: id: $ref: '#/components/schemas/CreditLoanId' financingLoans: type: array items: $ref: '#/components/schemas/Loan' minItems: 1 handover: $ref: '#/components/schemas/Handover' 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 CancelContractReason: type: object required: - key properties: key: $ref: '#/components/schemas/CancelContractReasonKey' CounterOfferBuildingSavingLoanCreditPhase: type: object required: - interestRate properties: interestRate: $ref: '#/components/schemas/InterestRate' 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' EstateId: type: object required: - value description: 'DE: ID der Immobilie.
EN: ID of the estate. ' properties: value: type: string 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 PreInquires: type: object required: - preInquires properties: preInquires: type: array items: $ref: '#/components/schemas/PreInquiry' SubmissionRevokedReasonKey: type: string description: 'DE: open ended enum enthält mögliche Gründe für den Widerruf der Anmeldung
EN: open ended enum contains possible submission revocation reasons ' example: TIME x-extensible-enum: - TIME - COND - DOCS - NO_OBJECT - MAIN - AUX - WRONG_BID - ERROR_USE - ERROR_TEC - TERMINATION - REALLOCATION - OTHER 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' RevokeSubmissionCounterOfferReason: type: object required: - key properties: key: $ref: '#/components/schemas/RevokeSubmissionCounterOfferReasonKey' 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' 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 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 ' 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. ' SubmissionAdditionalProduct: description: a specific submission additional product type: object required: - provider - product - commissionBase properties: additionalProductId: type: string provider: $ref: '#/components/schemas/CompanyId' product: $ref: '#/components/schemas/ProductType' applicants: type: array items: $ref: '#/components/schemas/ApplicantId' minItems: 1 policyNumber: type: string netBurden: $ref: '#/components/schemas/PeriodicalEuroAmount' duration: $ref: '#/components/schemas/Duration' commissionBase: $ref: '#/components/schemas/EuroAmount' commission: $ref: '#/components/schemas/Percentage' approved: description: a flag indicates whether the provided additional product has been approved and hence not changeable anymore. type: boolean nullable: true 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. ' 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). ' BasementDetail: type: object required: - key properties: key: $ref: '#/components/schemas/BasementDetailKey' 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' LoanDetails: description: details of the loan to be updated type: object required: - amount properties: amount: $ref: '#/components/schemas/EuroAmount' maturity: $ref: '#/components/schemas/InterestMaturity' interestRateUpdate: $ref: '#/components/schemas/InterestRateUpdate' specialRepayment: $ref: '#/components/schemas/SpecialRepayment' commission: $ref: '#/components/schemas/CommissionInfo' SetSubmissionDataViolationsCommand: description: command to indicate submission violations type: object required: - violations allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: violations: type: array items: $ref: '#/components/schemas/SubmissionDataViolation' minItems: 1 remark: type: string 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' AwaitExternalProcessingSubmissionCommand: type: object description: command to indicate that the processing will be stopped due to an external process e.g. object valuation etc, and is not related to the submission's quality required: - externalProcessing allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: externalProcessing: $ref: '#/components/schemas/ExternalProcessing' LoanPartnerDetails: type: object description: 'DE: Informationen zum Kreditgeber und der Einheit des Kreditgebers, welche den Kreditantrag bearbeitet. EN: Information about the loan partner and the processing unit of the financing partner. ' required: - loanPartner - processingUnit properties: loanPartner: $ref: '#/components/schemas/Company' processingUnit: $ref: '#/components/schemas/ProcessingUnit' processor: $ref: '#/components/schemas/Processor' 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' UpdateAdditionalProductsCommand: description: Modify additional products type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: additionalProducts: type: array items: $ref: '#/components/schemas/SubmissionAdditionalProduct' minItems: 0 BaseCalculation: type: object required: - type - loanType - calculationDate properties: type: $ref: '#/components/schemas/CalculationType' calculationDate: description: 'DE: Datum der Kalkulation.
EN: Calculation date. ' $ref: '#/components/schemas/ISODate' discriminator: propertyName: type 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 FinancingApplicationItem: type: object required: - id - _href description: 'A wrapper type Holds information about the requested financing application. Further details will be delivered in the embedded property if specified. Please refer to *Expansion* section for more details. ' properties: financingApplicationRef: $ref: '#/components/schemas/FinancingApplicationRef' embedded: $ref: '#/components/schemas/FinancingApplication' 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' Calculations: description: 'A wrapper Type to hold a set of calculations. ' type: object properties: calculations: type: array items: $ref: '#/components/schemas/CalculationItem' 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 CounterOfferBuildingSavingLoanSavingsPhase: type: object required: - interestRate properties: interestRate: $ref: '#/components/schemas/PeriodicalPercentage' BaseCommandTrigger: type: object required: - type properties: userId: $ref: '#/components/schemas/UserId' type: type: string x-extensible-enum: - ADVISOR - LOAN_PARTNER_PROCESSOR - SYSTEM discriminator: propertyName: type 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 DocumentId: required: - value properties: value: type: string description: 'An Id refers to a specific document resource. ' type: object description: 'DE: ID vom Dokument. EN: Id of the document. ' 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' ModifySubmissionCommand: oneOf: - $ref: '#/components/schemas/RevokeSubmissionCommand' - $ref: '#/components/schemas/AssignSubmissionLoanPartnerProcessorCommand' - $ref: '#/components/schemas/AssignSubmissionLoanPartnerProcessorDetailsCommand' - $ref: '#/components/schemas/UpdateLoanPartnerDecisionDateCommand' - $ref: '#/components/schemas/UpdateSubmissionLoanContractNumberCommand' - $ref: '#/components/schemas/ArchiveSubmissionCommand' - $ref: '#/components/schemas/UnArchiveSubmissionCommand' - $ref: '#/components/schemas/RejectSubmissionCommand' - $ref: '#/components/schemas/RevokeSubmissionRejectionCommand' - $ref: '#/components/schemas/CreateSubmissionCounterOfferCommand' - $ref: '#/components/schemas/DeliverContractSubmissionCommand' - $ref: '#/components/schemas/SignContractSubmissionCommand' - $ref: '#/components/schemas/AcceptSubmissionCounterOfferCommand' - $ref: '#/components/schemas/RejectSubmissionCounterOfferCommand' - $ref: '#/components/schemas/RevokeSubmissionCounterOfferCommand' - $ref: '#/components/schemas/AwaitExternalProcessingSubmissionCommand' - $ref: '#/components/schemas/ApproveSubmissionCommand' - $ref: '#/components/schemas/StartProcessingSubmissionCommand' - $ref: '#/components/schemas/CancelContractSubmissionCommand' - $ref: '#/components/schemas/PauseSubmissionProcessingCommand' - $ref: '#/components/schemas/ResumeSubmissionProcessingCommand' - $ref: '#/components/schemas/SetSubmissionDataViolationsCommand' - $ref: '#/components/schemas/RefuseSignContractCommand' - $ref: '#/components/schemas/ChangeLoanPartnerProcessingUnitCommand' - $ref: '#/components/schemas/CloseRejectedSubmissionCommand' - $ref: '#/components/schemas/UpdateSubmissionContactUserCommand' - $ref: '#/components/schemas/AddSubmissionLogbookNoteCommand' - $ref: '#/components/schemas/ApproveSubmissionCommissionChangeCommand' - $ref: '#/components/schemas/UpdateAdditionalProductsCommand' discriminator: propertyName: operation mapping: REVOKE_SUBMISSION: '#/components/schemas/RevokeSubmissionCommand' ASSIGN_PROCESSOR: '#/components/schemas/AssignSubmissionLoanPartnerProcessorCommand' ASSIGN_FULL_PROCESSOR: '#/components/schemas/AssignSubmissionLoanPartnerProcessorDetailsCommand' UPDATE_LOAN_PARTNER_DECISION_DATE: '#/components/schemas/UpdateLoanPartnerDecisionDateCommand' UPDATE_LOAN_CONTRACT_NUMBER: '#/components/schemas/UpdateSubmissionLoanContractNumberCommand' ARCHIVE_SUBMISSION: '#/components/schemas/ArchiveSubmissionCommand' UNARCHIVE_SUBMISSION: '#/components/schemas/UnArchiveSubmissionCommand' REJECT_SUBMISSION: '#/components/schemas/RejectSubmissionCommand' REVOKE_REJECTION: '#/components/schemas/RevokeSubmissionRejectionCommand' COUNTER_OFFER: '#/components/schemas/CreateSubmissionCounterOfferCommand' DELIVER_CONTRACT: '#/components/schemas/DeliverContractSubmissionCommand' SIGN_CONTRACT: '#/components/schemas/SignContractSubmissionCommand' ACCEPT_COUNTER_OFFER: '#/components/schemas/AcceptSubmissionCounterOfferCommand' REJECT_COUNTER_OFFER: '#/components/schemas/RejectSubmissionCounterOfferCommand' REVOKE_COUNTER_OFFER: '#/components/schemas/RevokeSubmissionCounterOfferCommand' AWAIT_EXTERNAL_PROCESSING: '#/components/schemas/AwaitExternalProcessingSubmissionCommand' APPROVE_SUBMISSION: '#/components/schemas/ApproveSubmissionCommand' START_PROCESSING: '#/components/schemas/StartProcessingSubmissionCommand' CANCEL_CONTRACT: '#/components/schemas/CancelContractSubmissionCommand' PAUSE_PROCESSING: '#/components/schemas/PauseSubmissionProcessingCommand' RESUME_PROCESSING: '#/components/schemas/ResumeSubmissionProcessingCommand' SET_SUBMISSION_DATA_VIOLATIONS: '#/components/schemas/SetSubmissionDataViolationsCommand' REFUSE_SIGN_CONTRACT: '#/components/schemas/RefuseSignContractCommand' CHANGE_LOAN_PARTNER_PROCESSING_UNIT: '#/components/schemas/ChangeLoanPartnerProcessingUnitCommand' CLOSE_REJECTED_SUBMISSION: '#/components/schemas/CloseRejectedSubmissionCommand' UPDATE_CONTACT_USER: '#/components/schemas/UpdateSubmissionContactUserCommand' ADD_SUBMISSION_LOGBOOK_NOTE: '#/components/schemas/AddSubmissionLogbookNoteCommand' APPROVE_SUBMISSION_COMMISSION_CHANGE: '#/components/schemas/ApproveSubmissionCommissionChangeCommand' UPDATE_ADDITIONAL_PRODUCTS: '#/components/schemas/UpdateAdditionalProductsCommand' 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' AssignSubmissionLoanPartnerProcessorCommand: description: assign a processor using an id type: object required: - processorId allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: processorId: $ref: '#/components/schemas/LoanPartnerProcessorId' 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' SubmissionOverview: readOnly: true type: object description: 'DE: Generelle Informationen ueber den Kreditantrag.
EN: General information about a specific submission. ' properties: status: $ref: '#/components/schemas/SubmissionStatus' submittedAt: description: 'DE: Datum der Einreichung.
EN: Date when this submission has been submitted. ' $ref: '#/components/schemas/ISODateTime' reviewedAt: description: 'DE: Datum der Überprüfung.
EN: Date when this submission has been reviewed. ' $ref: '#/components/schemas/ISODateTime' initialEstimate: deprecated: true description: '@deprecated: Use field timeline instead. ' $ref: '#/components/schemas/InitialSubmissionEstimate' timeline: description: 'DE: Zeitplan einer Einreichung. EN: Timeline of a submission. ' $ref: '#/components/schemas/SubmissionTimeline' submittedBy: description: 'DE: Informationen über den Berater der den Kreditantrag abgesendet hat.
EN: Information about the advisor, who has triggered the submission process. ' $ref: '#/components/schemas/Advisor' submitter: description: 'DE: Informationen über den Berater der den Kreditantrag abgesendet hat.
EN: Information about the advisor, who has triggered the submission process. ' $ref: '#/components/schemas/OrganizationUser' contactUser: description: 'DE: Informationen über den für die Einreichung verantwortlichen Kontaktnutzer.
EN: Information about the contact user responsible for the submission. ' $ref: '#/components/schemas/OrganizationUser' loanPartner: description: This field is deprecated. Please use the 'loanPartnerDetails' instead. deprecated: true $ref: '#/components/schemas/LoanPartnerProcessingInfo' loanPartnerDetails: $ref: '#/components/schemas/LoanPartnerDetails' additionalFields: $ref: '#/components/schemas/AdditionalFields' useNewModifyCommandVersion: description: Flag indicates whether the usage of the new status interface is required for this submission. type: boolean useNewUploadVersion: description: Flag indicates whether the usage of new upload for documents is required for this submission. type: boolean 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' LoanPartnerProcessorName: description: 'DE: Username, Vor- und Nachname des (Kredit-)Bearbeiters.
EN: Username, first- and lastname of the loan partner processor. ' required: - userName properties: userName: type: string firstName: type: string lastName: type: string 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 PreInquiryStatusKey: type: string description: 'DE: Status des Voranfrage.
EN: Status of the preInquiry. ' x-extensible-enum: - CREATED - INWORK - SUBMITTED - ACCEPTED - ACCEPTED_WITH_PROPOSAL - REJECTED - ABORTED - TERMINATED 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}$ SignContractSubmissionCommand: type: object description: command to sign the contract after successful credit decision. required: - contracts - contractSignDate allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: remark: type: string contracts: type: array minItems: 1 items: $ref: '#/components/schemas/ExtendedContractInfo' contractSignDate: description: 'DE: Datum der Unterschrift des Vertrages.
EN: Contract sign date. ' $ref: '#/components/schemas/ISODate' 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' ApproveSubmissionCommissionChangeCommand: description: Approve modified commission type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' 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' LoanConditionSummary: description: 'DE: Zusammenfassung von Informationen zu einzelnem Darlehen (Konditionskalkulation).
EN: Summary information about single loan (conditions calculation). ' type: object properties: effectiveRate: description: 'DE: Effektiver Zins.
EN: Effective interest rate. ' $ref: '#/components/schemas/PeriodicalPercentage' nominalRate: description: 'DE: Sollzins
EN: Nominal rate. ' $ref: '#/components/schemas/PeriodicalPercentage' trueEffectiveRate: description: 'DE: Summe effektiver Bestandteile.
EN: True effective rate. ' $ref: '#/components/schemas/PeriodicalPercentage' additionalInfo: x-is-plural: true type: array items: $ref: '#/components/schemas/AdditionalInfo' 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 LoanPartnerQueueId: type: object required: - value description: 'DE: ID der loan parnter queue.
EN: Loan partner queue id. ' properties: value: type: string 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 LoanPartnerQueue: type: object required: - id description: 'DE: Informationen zur Kredigeber Warteschlange. EN: Information about loan partner queue. ' properties: id: description: 'DE: ID der Kredigeber Warteschlange.
EN: Loan partner queue id. ' $ref: '#/components/schemas/LoanPartnerQueueId' name: description: 'DE: Name der Kredigeber Warteschlange. EN: Name of the loan partner queue. ' type: string description: description: 'DE: Beschreibung der Kreditgeber Warteschlange: EN: Description of the loan partner queue. ' 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' UpdateSubmissionContactUserCommand: description: command to update assigned contact user of the submission type: object required: - userId - companyId allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: userId: $ref: '#/components/schemas/UserId' companyId: $ref: '#/components/schemas/CompanyId' 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 DetailType: type: string description: 'DE: Kategorie des Kalkulkationwertes (nicht abschließende Aufzählung), z.B. ENTRY, SUB_TOTAL.
EN: Calculated value category - open ended enum contains property type details, possible values are ENTRY, SUB_TOTAL. ' example: ENTRY x-extensible-enum: - ENTRY - SUB_TOTAL 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' BaseSubmissionCommand: type: object required: - operation properties: trigger: $ref: '#/components/schemas/CommandTrigger' createdOn: $ref: '#/components/schemas/ISODateTime' operation: type: string x-extensible-enum: - REVOKE_SUBMISSION - ASSIGN_PROCESSOR - UPDATE_LOAN_PARTNER_DECISION_DATE - UPDATE_LOAN_CONTRACT_NUMBER - ARCHIVE_SUBMISSION - UNARCHIVE_SUBMISSION - REJECT_SUBMISSION - REVOKE_REJECTION - COUNTER_OFFER - ACCEPT_COUNTER_OFFER - REJECT_COUNTER_OFFER - REVOKE_COUNTER_OFFER - DELIVER_CONTRACT - SIGN_CONTRACT - AWAIT_EXTERNAL_PROCESSING - APPROVE_SUBMISSION - START_PROCESSING - PAUSE_PROCESSING - RESUME_PROCESSING - SET_SUBMISSION_DATA_VIOLATIONS - REFUSE_SIGN_CONTRACT - CHANGE_LOAN_PARTNER_PROCESSING_UNIT - CLOSE_REJECTED_SUBMISSION - ADD_SUBMISSION_LOGBOOK_NOTE - APPROVE_SUBMISSION_COMMISSION_CHANGE - UPDATE_ADDITIONAL_PRODUCTS discriminator: propertyName: operation 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' SubmissionDocumentBinary: type: string format: binary 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' ResidualDebtProtectionBuildingSavingPlan: allOf: - $ref: '#/components/schemas/BaseResidualDebtProtection' - type: object required: - buildingSavingPlan properties: buildingSavingPlan: $ref: '#/components/schemas/BuildingSavingPlan' 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' BusinessLine: type: object required: - key properties: key: $ref: '#/components/schemas/BusinessLineKey' 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' 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 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" SubmissionRejectedStatus: type: object description: 'EN: Status containing information about rejection ' required: - type - reasons allOf: - $ref: '#/components/schemas/BaseSubmissionStatus' properties: reasons: type: array minItems: 1 items: $ref: '#/components/schemas/RejectReason' 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' Client: type: object required: - key properties: key: $ref: '#/components/schemas/ClientKey' CommandId: type: object required: - value properties: value: type: string DocumentMetaData: type: object deprecated: true properties: submissionId: $ref: '#/components/schemas/SubmissionId' documentId: $ref: '#/components/schemas/DocumentId' documentType: type: string description: 'A type refers to a specific document resource. ' x-extensible-enum: - CONDITION_CALCULATION - CONDITION_CALCULATION_KFW - HANDOVER_PROTOCOL - HOUSEHOLD_CALCULATION - MORTGAGE_LENDING_VALUE_CALCULATION - REVISED_FUNDING_APPLICATION - PROVIDER_COVER_LETTER - PROHYP_COVER_LETTER - COMMISSION_REQUIREMENT_SHEET - PRE_CONTRACTUAL_INFORMATION - ADVISORS_SURVEY - DSL_FAX_PROLONGATION - ING_INFO_SHEET - FACT_SHEET - DEBT_SERVICE_CALCULATION - REALESTATE_VALUATION - OBJECT_DATA_SHEET - ADDITIONAL_PROPERTY_1_OBJECT_DATA_SHEET - ADDITIONAL_PROPERTY_2_OBJECT_DATA_SHEET - ADDITIONAL_PROPERTY_3_OBJECT_DATA_SHEET - ADDITIONAL_PROPERTY_4_OBJECT_DATA_SHEET - ADDITIONAL_PROPERTY_5_OBJECT_DATA_SHEET - CHECKLIST_MORTGAGE_ASSIGNMENT documentName: type: string description: 'A name refers to a specific document resource. ' href: $ref: '#/components/schemas/ResourceRef' createdAt: $ref: '#/components/schemas/ISODateTime' 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 RejectSubmissionCommand: description: command to reject a submission during credit decision phase providing information about the cause of the rejection. type: object required: - rejection allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: rejection: $ref: '#/components/schemas/SubmissionRejection' 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' ExternalProcessing: type: object description: 'EN: Information regarding the external processing ' required: - details properties: details: type: array minItems: 1 items: $ref: '#/components/schemas/ExternalProcessingDetail' estimatedConclusion: $ref: '#/components/schemas/ISODate' remark: type: string 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 ' CounterOfferSuspendedAmortizationCombinedProduct: oneOf: - $ref: '#/components/schemas/CounterOfferBuildingSavingLoan' discriminator: propertyName: product mapping: BAU_SPAR: '#/components/schemas/CounterOfferBuildingSavingLoan' 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' SubmissionOverviewItem: type: object required: - submittedAt - _href description: 'Holds overview information about the requested Submission. Further details will be delivered in the embedded property if specified. Please refer to *Expansion* section for more details. ' properties: submittedAt: description: 'DE: Datum der Einreichung.
EN: Date when this submission has been submitted. ' $ref: '#/components/schemas/ISODateTime' _href: x-skip-camel-case-check: true $ref: '#/components/schemas/ResourceRef' embedded: $ref: '#/components/schemas/SubmissionOverview' AcceptSubmissionCounterOfferCommand: type: object description: command to accept a counter offer. required: - counterOfferId allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: counterOfferId: $ref: '#/components/schemas/SubmissionCounterOfferId' remark: type: string 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' UnArchiveSubmissionCommand: description: Remove the archived flag from a submission. type: object allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' SpecialRealEstateCharacteristics: oneOf: - $ref: '#/components/schemas/SpecialHouseCharacteristics' - $ref: '#/components/schemas/DefaultSpecialRealEstateCharacteristics' discriminator: propertyName: type mapping: HOUSE: '#/components/schemas/SpecialHouseCharacteristics' DEFAULT: '#/components/schemas/DefaultSpecialRealEstateCharacteristics' UpdateLoanPartnerDecisionDateCommand: description: Update the predicted decision date of a submission. type: object required: - decisionDate allOf: - $ref: '#/components/schemas/BaseSubmissionCommand' properties: decisionDate: $ref: '#/components/schemas/PredictedLoanPartnerDecisionDate' 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' RejectSubmissionCounterOfferReasonKey: type: string description: 'DE: offenes Enum enthält mögliche Gründe für die Ablehnung eines Gegenangebots, mögliche Werte sind (CONDITION_NOT_ATTRACTIVE_FOR_CUSTOMER = Konditionen waren für den Kunden nicht attraktiv, CUSTOMER_DECIDED_DIFFERENT_PROVIDER=Kunden hat sich für einen anderen Finanzierungspartner (besseres Angebot) entschieden, CONDITION_NOT_FEASIBLE_FOR_CUSTOMER=Bedingung der Bank für den Kunden nicht darstellbar, OTHER=Nicht aufgeführter Grund). EN: open ended enum contains possible counter offer rejection reasons, possible values are (CONDITION_NOT_ATTRACTIVE_FOR_CUSTOMER, CUSTOMER_DECIDED_DIFFERENT_PROVIDER, CONDITION_NOT_FEASIBLE_FOR_CUSTOMER, OTHER). ' example: OTHER x-extensible-enum: - CONDITION_NOT_ATTRACTIVE_FOR_CUSTOMER - CUSTOMER_DECIDED_DIFFERENT_PROVIDER - CONDITION_NOT_FEASIBLE_FOR_CUSTOMER - OTHER 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 ClientKey: type: string description: 'DE: Datenquelle, mögliche Werte: INTERHYP_ASP, COBA_ASP.
EN: Enum representing data origin, possible values are INTERHYP_ASP, COBA_ASP. ' example: INTERHYP_ASP x-extensible-enum: - INTERHYP_ASP - COBA_ASP FinancialBurdenDetail: description: 'DE: Detailierte Information über den Belastungsplan innerhalb der Haushaltsrechnung.
EN: Detailed information about financial burden within household calculation. ' type: object properties: index: description: 'DE: Reihenfolge Index innerhalb Belastungsplan.
EN: Order index within financial burden. ' type: integer deadline: description: 'DE: Stichtag für die Belastung.
EN: Burden deadline. ' $ref: '#/components/schemas/ISODate' occasion: type: string description: 'DE: Anlass der Belastung.
EN: Burden reason. ' description: type: string description: 'DE: Beschreibung der Belastung.
EN: Burden description. ' deltaLiquidity: description: 'DE: Deltaliquidität.
EN: Delta liquidity. ' $ref: '#/components/schemas/EuroAmount' residualLiquidity: description: 'DE: Restliquidität.
EN: Residual liquidity. ' $ref: '#/components/schemas/EuroAmount' 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' PredictedLoanPartnerDecisionDate: description: 'DE: Voraussichtliches Entscheidungsdatum des Kreditgebers.
EN: Predicted decision date of the loan partner. ' type: object required: - date properties: date: $ref: '#/components/schemas/ISODate' reason: type: string description: 'DE: Begründung für das voraussichtliche Entscheidungsdatum. EN: Reason for the predicted decision date. ' SubmissionStatusType: type: string description: 'DE: Mögliche Status der Einreichung (nicht abschließende Aufzählung), z.B. (REJECTED, CONTRACT_DELIVERED)
EN: Open ended enum contains submission status value, possible values are (REJECTED, CONTRACT_DELIVERED) ' example: REJECTED x-extensible-enum: - REJECTED - CONTRACT_DELIVERED - CONTRACT_SIGNED - INWORK - APPROVED - REJECTION_REVOKED - AWAIT_EXTERNAL_PROCESSING - CREATED - SUBMITTED - AVAILABLE_FOR_DECISION - REVOKED - ANONYMIZED - COUNTER_OFFER_CREATED - COUNTER_OFFER_ACCEPTED - COUNTER_OFFER_REJECTED - PROCESSING_PAUSED - CONTRACT_SIGN_REFUSED - CONTRACT_CANCELED - CONFIRMED - REJECTED_AND_CLOSED RejectReasonKey: type: string x-extensible-enum: - OBJ_CRAFT - GRND_PRICE - BAD_UTILIZE - BAD_STATE - LUX_HOBBY - CREDIT_NEG - REL_DEBIT - HH_INC_TO_VOL - HH_CREDITS - HH_NO_DEDUCT - HH_HI_INCOME - HH_EXPENSES - HH_NEG_BAL - SCHUFA_NEG - SCHUFA_SCOR - INTERN_RED - FRAME - LOW_EQUITY - DEBT_RATIO - JOB_AMOUNT - RENT_RISK - PROBATION - SHORT_SE - SECTION2 - SECTION3 - EXIST_CUST - MANIPULATE - EVIDENCE - UNKNOWN - CONTRACT - OVERALL_CONSTELLATION - NEGATIVE_HOUSEHOLD_CALCULATION - PROPERTY_VALUATION_LOAN_QUOTA - OTHER 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 ProductType: type: object required: - key properties: key: $ref: '#/components/schemas/ProductTypeKey' 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 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' 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. ' LoanPartnerProcessorId: description: 'DE: ID des (Kredit-)Bearbeiters.
EN: Id of the loan partner processor. ' required: - value properties: value: type: string LoanPartnerProcessorEmail: description: 'DE: E-Mail Adresse des (Kredit-)Bearbeiters.
EN: E-Mail address of the loan partner processor. ' properties: email: type: string 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 PreInquiryStatus: type: object required: - key properties: key: $ref: '#/components/schemas/PreInquiryStatusKey' 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' 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 parameters: handover-report-name: name: name in: path required: true schema: type: string description: Document Id for the requested handover report. example: MTIzNDU2Ny1QUk9WSURFUl9DT1ZFUl9MRVRURVItUHJvdmlkZXJhbnNjaHJlaWJlbg== since: name: since in: query description: 'A UTC date-time value that points to the start of the range of time-based data. Defined by date-time - [RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14).' required: true schema: type: string format: date-time example: 2019-12-29 10:22:50+00:00 cursor-after: name: after in: query description: Cursor that points to the end of the page of data that has been returned. required: false schema: type: string credit-loan-id: name: creditLoanId in: path required: true schema: type: string description: Id for the requested credit loan. calculation-type: name: calculationType in: path required: true schema: type: string enum: - household - condition - lending_value description: Subtype of the calculation data. sbms-sort: name: sort in: query style: form required: false description: 'To indicate sorting direction, fields may be prefixed with `+` ascending or `-` descending. Note: sorting applies only within a single result page when multiple pages are returned.' example: ?sort=+submittedAt schema: type: string enum: - +submittedAt - -submittedAt cursor-before: name: before in: query description: Cursor that points to the start of the page of data that has been returned. required: false schema: type: string 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' submission-id: name: submissionId in: path required: true schema: type: string description: Id for the requested submission. document-id: name: documentId in: path required: true schema: type: string description: Id for the requested submission document. sbms-limit: name: limit in: query description: 'Specifies how many items to return at one time (max 50). A query may return fewer than the value of limit due to filtering.' required: false schema: type: integer format: int32 minimum: 1 maximum: 50 default: 20 until: name: until in: query description: 'A UTC date-time value that points to the end of the range of time-based data. If not provided, current date-time is used. Defined by date-time - [RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14).' required: false schema: type: string format: date-time example: 2019-12-29 10:22:50+00:00 securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT