openapi: 3.0.2 info: title: Interhyp Submission commands logbook 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: logbook description: provides endpoints to access submission logbook paths: /submissions/{submissionId}/logbook: get: summary: Get submission logbook entries description: Delivers detailed information about logbook entries associated with a specific submission. operationId: getLogbookBySubmissionId tags: - logbook parameters: - $ref: '#/components/parameters/submission-id' responses: '200': description: Submission logbook entries are returned content: application/json: schema: $ref: '#/components/schemas/SubmissionLogbook' '400': description: Error indicates missing or wrong request parameters. content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' '401': description: Error indicates no access to the required resource. content: application/json: schema: $ref: '#/components/schemas/OAuthProblem' '404': description: Error indicates that a requested submission resource was not found. content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' '500': description: Unexpected Error content: application/json: schema: $ref: '#/components/schemas/RFC7807Problem' components: schemas: DefaultLogbookEntry: allOf: - $ref: '#/components/schemas/BaseLogbookEntry' 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' 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' UploadedDocumentTypeKey: type: string example: CONTRACT x-extensible-enum: - CONTRACT - CONTRACT_ADDENDA - LAND_REGISTER_EXTRACT - PAYOUT_REQUIREMENT - OTHER 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 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. ' InterestMaturity: oneOf: - $ref: '#/components/schemas/VariableInterestMaturity' - $ref: '#/components/schemas/FixedInterestMaturity' discriminator: propertyName: type mapping: VARIABLE: '#/components/schemas/VariableInterestMaturity' FIXED_PERIOD: '#/components/schemas/FixedInterestMaturity' AssignProcessorLogbookEntry: type: object description: 'DE: Ein Logbucheintrag mit Informationen zu dem neu zugewiesenen Bearbeiter.
EN: A logbook entry holds information about assigning a loan partner processor to the submission. ' allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: assignedTo: $ref: '#/components/schemas/UserData' AcceptedCounterOfferLogbookEntryDetails: type: object description: Accepted counter offer submission logbook entry details required: - id allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: id: $ref: '#/components/schemas/SubmissionCounterOfferId' RefuseSignContractReason: type: object required: - key properties: key: $ref: '#/components/schemas/RefuseSignContractReasonKey' 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 Title: type: object required: - key properties: key: $ref: '#/components/schemas/TitleKey' 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' 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' LoanId: type: object description: 'DE: ID des Darlehens.
EN: Loan identifier. ' properties: value: type: string 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' 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' PauseReason: type: object required: - key properties: key: $ref: '#/components/schemas/PauseReasonKey' 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' 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' SubmissionStatusChangedLogbookEntry: type: object allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: details: $ref: '#/components/schemas/SubmissionStatusChangedLogbookEntryDetails' BaseSpecialRepayment: type: object required: - type description: 'DE: Information zur Sondertilgung.
EN: Special repayment information. ' properties: type: $ref: '#/components/schemas/SpecialRepaymentType' discriminator: propertyName: type 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 LogbookEntryType: type: string description: 'DE: Art des Logbookentry (nicht abschließende Aufzählung), z.B. (SUBMISSION_CREATED, SUBMISSION_EDITED, DECISION_DATE_UPDATED, UPLOADED_DOCUMENT, STATUS).
EN: open ended enum contains possible logbook entry types, possible values are (SUBMISSION_CREATED, SUBMISSION_EDITED, DECISION_DATE_UPDATED, UPLOADED_DOCUMENT, STATUS). ' example: UPLOADED_DOCUMENT x-extensible-enum: - SUBMISSION_CREATED - SUBMISSION_EDITED - SUBMISSION_MIGRATED - SUBMISSION_CREDIT_LOANS_UPDATED - LOAN_PARTNER_PROCESSOR_ASSIGNED - UPLOADED_DOCUMENT - DECISION_DATE_UPDATED - STATUS - SUBMISSION_COUNTER_OFFER_REVOKED - SUBMISSION_STATUS_CHANGED - CONTACT_ADVISOR_UPDATED - LOAN_CONTRACT_NUMBER_UPDATED - SUBMISSION_DATA_VIOLATIONS_SET - SUBMISSION_REVOKED - SUBMISSION_LOAN_PARTNER_DOCUMENT_CREATED - SUBMISSION_LOAN_PARTNER_DOCUMENT_UPDATED - SUBMISSION_LOAN_PARTNER_DOCUMENT_DELETED - LOAN_PARTNER_PROCESSING_UNIT_CHANGED - SUBMISSION_NOTE_ADDED DefaultSubmissionStatusChangedLogbookEntryDetails: allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' 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 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' 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 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' 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' 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 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 InterestRateUpdate: oneOf: - $ref: '#/components/schemas/AnnuityInterestRateUpdate' - $ref: '#/components/schemas/BuildingSavingPlanInterestRateUpdate' discriminator: propertyName: rateUpdateType mapping: ANNUITY: '#/components/schemas/AnnuityInterestRateUpdate' BUILDING_SAVING_PLAN: '#/components/schemas/BuildingSavingPlanInterestRateUpdate' DecisionDateLogbookEntry: type: object description: 'DE: Ein Logbucheintrag mit Informationen zu dem geänderten Entscheidungsdatum.
EN: A logbook entry holds information about updating submission decision date. ' allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: newDecisionDate: $ref: '#/components/schemas/ISODate' SubmissionAdditionalProductsUpdatedLogbookEntryDetails: type: object properties: updatedProducts: type: array items: $ref: '#/components/schemas/SubmissionAdditionalProduct' minItems: 0 originalProducts: type: array items: $ref: '#/components/schemas/SubmissionAdditionalProduct' minItems: 0 BaseLogbookEntry: type: object required: - id - type description: 'DE: Informationen zu einem Logbucheintrag.
EN: Holds information about a logbook entry. ' properties: id: $ref: '#/components/schemas/LogbookEntryId' type: $ref: '#/components/schemas/LogbookEntryType' createdAt: description: 'DE: Ein UTC Zeitstempel wann die mit dem Logbucheintrag verknüpfte Aktion ausgelöst wurde.
EN: A UTC date-time indicates when the event associated to the logbook entry took place. ' $ref: '#/components/schemas/ISODateTime' createdBy: description: 'DE: Der Nutzer, welcher die Aktion ausgelöst hat, die zu dem Logbucheintrag führt.
EN: User who triggered the event associated to the logbook entry. ' $ref: '#/components/schemas/UserData' remark: type: string discriminator: propertyName: type 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 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 DebtId: type: object description: 'DE: ID der Verbindlichkeit.
EN: ID of the associated Debt. ' required: - value properties: value: type: string OpenPropertySale: type: object description: 'DE: Information zur Zwischenfinanzierung in Zusammenhang mit einem Immobilienverkauf.
EN: Information about bridging debt associated with property sale. ' allOf: - $ref: '#/components/schemas/BaseBridgingLoanDetails' properties: debtAmount: description: 'DE: Aktuelle Grundschuldhöhe.
EN: Current debt amount. ' $ref: '#/components/schemas/EuroAmount' residualDebt: description: 'DE: Aktuelle Restschuld.
EN: Current remaining debt. ' $ref: '#/components/schemas/EuroAmount' 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. ' 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 RejectedCounterOfferLogbookEntryDetails: type: object required: - id allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: id: $ref: '#/components/schemas/SubmissionCounterOfferId' reason: $ref: '#/components/schemas/RejectSubmissionCounterOfferReason' 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' ContractCanceledStatusLogbookEntryDetails: type: object allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: reason: $ref: '#/components/schemas/CancelContractReason' cancellationDate: $ref: '#/components/schemas/ISODate' 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 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' RejectReason: type: object required: - key properties: key: $ref: '#/components/schemas/RejectReasonKey' ApplicantId: type: object required: - value properties: value: description: 'DE: Id des Antragstellers.
EN: Id of the applicant. ' type: string example: '1' LoanPartnerQueueId: type: object required: - value description: 'DE: ID der loan parnter queue.
EN: Loan partner queue id. ' properties: value: type: string LogbookEntryId: type: object properties: value: type: string 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 AuxProductType: type: object required: - key properties: key: $ref: '#/components/schemas/AuxProductTypeKey' 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 SubmissionRevokedReason: type: object required: - key properties: key: $ref: '#/components/schemas/SubmissionRevokedReasonKey' 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 CreditLoanId: type: object description: 'DE: Id der Finanzierungsstruktur.
EN: Credit Loan identifier. ' required: - value properties: value: type: string 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 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 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' SubmissionLogbookEntry: oneOf: - $ref: '#/components/schemas/DefaultLogbookEntry' - $ref: '#/components/schemas/AssignProcessorLogbookEntry' - $ref: '#/components/schemas/DocumentLogbookEntry' - $ref: '#/components/schemas/DecisionDateLogbookEntry' - $ref: '#/components/schemas/CounterOfferRevokedLogbookEntry' - $ref: '#/components/schemas/SubmissionStatusChangedLogbookEntry' - $ref: '#/components/schemas/ContactAdvisorUpdatedLogbookEntry' - $ref: '#/components/schemas/LoanContractNumberUpdatedLogbookEntry' - $ref: '#/components/schemas/SubmissionDataViolationsLogbookEntry' - $ref: '#/components/schemas/RevokedSubmissionLogbookEntry' - $ref: '#/components/schemas/SubmissionLoanPartnerDocumentLogbookEntry' - $ref: '#/components/schemas/LoanPartnerProcessingUnitChangedLogbookEntry' - $ref: '#/components/schemas/SubmissionAdditionalProductsUpdatedLogbookEntry' discriminator: propertyName: type mapping: SUBMISSION_CREATED: '#/components/schemas/DefaultLogbookEntry' SUBMISSION_EDITED: '#/components/schemas/DefaultLogbookEntry' SUBMISSION_NOTE_ADDED: '#/components/schemas/DefaultLogbookEntry' SUBMISSION_CREDIT_LOANS_UPDATED: '#/components/schemas/DefaultLogbookEntry' SUBMISSION_MIGRATED: '#/components/schemas/DefaultLogbookEntry' LOAN_PARTNER_PROCESSOR_ASSIGNED: '#/components/schemas/AssignProcessorLogbookEntry' UPLOADED_DOCUMENT: '#/components/schemas/DocumentLogbookEntry' DECISION_DATE_UPDATED: '#/components/schemas/DecisionDateLogbookEntry' SUBMISSION_COUNTER_OFFER_REVOKED: '#/components/schemas/CounterOfferRevokedLogbookEntry' SUBMISSION_STATUS_CHANGED: '#/components/schemas/SubmissionStatusChangedLogbookEntry' CONTACT_ADVISOR_UPDATED: '#/components/schemas/ContactAdvisorUpdatedLogbookEntry' LOAN_CONTRACT_NUMBER_UPDATED: '#/components/schemas/LoanContractNumberUpdatedLogbookEntry' SUBMISSION_DATA_VIOLATIONS_SET: '#/components/schemas/SubmissionDataViolationsLogbookEntry' SUBMISSION_REVOKED: '#/components/schemas/RevokedSubmissionLogbookEntry' SUBMISSION_LOAN_PARTNER_DOCUMENT_CREATED: '#/components/schemas/SubmissionLoanPartnerDocumentLogbookEntry' SUBMISSION_LOAN_PARTNER_DOCUMENT_UPDATED: '#/components/schemas/SubmissionLoanPartnerDocumentLogbookEntry' SUBMISSION_LOAN_PARTNER_DOCUMENT_DELETED: '#/components/schemas/SubmissionLoanPartnerDocumentLogbookEntry' LOAN_PARTNER_PROCESSING_UNIT_CHANGED: '#/components/schemas/LoanPartnerProcessingUnitChangedLogbookEntry' ADDITIONAL_PRODUCTS_UPDATED: '#/components/schemas/SubmissionAdditionalProductsUpdatedLogbookEntry' SpecialRepayment: oneOf: - $ref: '#/components/schemas/PercentageSpecialRepayment' - $ref: '#/components/schemas/TextSpecialRepayment' discriminator: propertyName: type mapping: PERCENTAGE: '#/components/schemas/PercentageSpecialRepayment' TEXT: '#/components/schemas/TextSpecialRepayment' KfwCallType: type: object required: - key properties: key: $ref: '#/components/schemas/KfwCallTypeKey' 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 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 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' 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' SubmissionStatusChangedLogbookEntryDetails: oneOf: - $ref: '#/components/schemas/ContractDeliveredStatusLogbookEntryDetails' - $ref: '#/components/schemas/ContractSignedStatusLogbookEntryDetails' - $ref: '#/components/schemas/ContractCanceledStatusLogbookEntryDetails' - $ref: '#/components/schemas/ExternalProcessingAwaitedLogbookEntryDetails' - $ref: '#/components/schemas/SubmissionProcessingPausedStatusLogbookEntryDetails' - $ref: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails' - $ref: '#/components/schemas/SubmissionProcessingResumedStatusLogbookEntryDetails' - $ref: '#/components/schemas/RejectSubmissionStatusChangedLogbookEntryDetails' - $ref: '#/components/schemas/CreatedCounterOfferLogbookEntryDetails' - $ref: '#/components/schemas/AcceptedCounterOfferLogbookEntryDetails' - $ref: '#/components/schemas/RejectedCounterOfferLogbookEntryDetails' - $ref: '#/components/schemas/ContractSignRefusedStatusLogbookEntryDetails' discriminator: propertyName: type mapping: CONTRACT_DELIVERED: '#/components/schemas/ContractDeliveredStatusLogbookEntryDetails' CONTRACT_SIGNED: '#/components/schemas/ContractSignedStatusLogbookEntryDetails' CONTRACT_CANCELED: '#/components/schemas/ContractCanceledStatusLogbookEntryDetails' AWAIT_EXTERNAL_PROCESSING: '#/components/schemas/ExternalProcessingAwaitedLogbookEntryDetails' PROCESSING_PAUSED: '#/components/schemas/SubmissionProcessingPausedStatusLogbookEntryDetails' INWORK: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails' APPROVED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails' REJECTED_AND_CLOSED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails' PROCESSING_RESUMED: '#/components/schemas/SubmissionProcessingResumedStatusLogbookEntryDetails' CANCELED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails' CONFIRMED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails' REJECTION_REVOKED: '#/components/schemas/DefaultSubmissionStatusChangedLogbookEntryDetails' REJECTED: '#/components/schemas/RejectSubmissionStatusChangedLogbookEntryDetails' COUNTER_OFFER_CREATED: '#/components/schemas/CreatedCounterOfferLogbookEntryDetails' COUNTER_OFFER_ACCEPTED: '#/components/schemas/AcceptedCounterOfferLogbookEntryDetails' COUNTER_OFFER_REJECTED: '#/components/schemas/RejectedCounterOfferLogbookEntryDetails' CONTRACT_SIGN_REFUSED: '#/components/schemas/ContractSignRefusedStatusLogbookEntryDetails' 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' 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 RejectSubmissionStatusChangedLogbookEntryDetails: type: object allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: reason: $ref: '#/components/schemas/RejectReason' solution: type: string 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' 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 BaseInterestRateUpdate: type: object required: - rateUpdateType properties: rateUpdateType: type: string x-extensible-enum: - ANNUITY - BUILDING_SAVING_PLAN discriminator: propertyName: rateUpdateType Cycle: description: 'DE: Wrapper für Zykluswerte
EN: Wrapper for cycle values. ' type: object required: - key properties: key: $ref: '#/components/schemas/CycleKey' 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 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 SubmissionAdditionalProductsUpdatedLogbookEntry: type: object allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: details: $ref: '#/components/schemas/SubmissionAdditionalProductsUpdatedLogbookEntryDetails' CreatedCounterOfferLogbookEntryDetails: type: object allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: originalComponents: type: array items: $ref: '#/components/schemas/CreditLoan' offer: $ref: '#/components/schemas/SubmissionCounterOffer' 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' 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' UserData: type: object properties: userId: $ref: '#/components/schemas/UserId' name: $ref: '#/components/schemas/PersonName' contact: $ref: '#/components/schemas/Contact' jobTitle: type: string LoanPartnerProcessingUnitChangedLogbookEntry: type: object required: - updatedProcessingUnit - previousProcessingUnit allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: updatedProcessingUnit: $ref: '#/components/schemas/ProcessingUnit' previousProcessingUnit: $ref: '#/components/schemas/ProcessingUnit' 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' 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 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' 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 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' 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' CompanyName: type: object properties: name: type: string BaseSuspendedAmortizationCombinedProduct: type: object required: - product properties: product: $ref: '#/components/schemas/SuspendedRepaymentProductTypeKey' discriminator: propertyName: product UploadedDocumentType: type: object required: - key properties: key: $ref: '#/components/schemas/UploadedDocumentTypeKey' 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 SubmissionDataViolationSeverityKey: type: string x-extensible-enum: - INFO - WARN - ERROR SubmissionDataViolationsLogbookEntry: type: object allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: submissionDataViolations: type: array items: $ref: '#/components/schemas/SubmissionDataViolation' PhoneReachability: type: object required: - key properties: key: $ref: '#/components/schemas/PhoneReachabilityKey' 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' PauseReasonKey: type: string x-extensible-enum: - DOCUMENTS - INFOS - BY_CUSTOMER - ONHOLD - EXPERTISE - ORIG_CONTR - REJ_SOON - FIN_APPROV - MIN_DOCS - OTHER 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' ContactAdvisorUpdatedLogbookEntry: type: object allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: updatedUserContact: $ref: '#/components/schemas/UserData' 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' 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' CancelContractReason: type: object required: - key properties: key: $ref: '#/components/schemas/CancelContractReasonKey' EstateId: type: object required: - value description: 'DE: ID der Immobilie.
EN: ID of the estate. ' properties: value: type: string SubmissionLoanPartnerDocumentLogbookEntry: type: object required: - documentId allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: documentId: $ref: '#/components/schemas/DocumentId' documentType: $ref: '#/components/schemas/UploadedDocumentType' filename: type: string 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' 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 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 SuspendedRepaymentProductType: type: object required: - key properties: key: $ref: '#/components/schemas/SuspendedRepaymentProductTypeKey' 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' 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' 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 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' ContractSignedStatusLogbookEntryDetails: type: object allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: contractSignDate: $ref: '#/components/schemas/ISODate' contracts: type: array items: $ref: '#/components/schemas/ExtendedContractInfo' 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 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 RevokeSubmissionCounterOfferReason: type: object required: - key properties: key: $ref: '#/components/schemas/RevokeSubmissionCounterOfferReasonKey' 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' 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' 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 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' 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 SubmissionProcessingPausedStatusLogbookEntryDetails: type: object allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: reason: $ref: '#/components/schemas/PauseReason' dueDate: $ref: '#/components/schemas/ISODate' CreditPhaseInterest: type: object properties: interestRate: $ref: '#/components/schemas/InterestRate' interestPayed: description: 'DE: Sollzinsen insgesamt.
EN: Total of credit interest payed. ' $ref: '#/components/schemas/EuroAmount' 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 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). ' 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. ' SubmissionCounterOfferId: type: object required: - value description: 'DE: ID vom Gegenangebot. EN: Id of the counter offer. ' properties: value: type: string 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' 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' 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 ExternalProcessingAwaitedLogbookEntryDetails: type: object allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: externalProcessing: $ref: '#/components/schemas/ExternalProcessing' SavingsPlanBurdenSpecialPaymentPeriod: type: object required: - from - to properties: from: $ref: '#/components/schemas/ISODate' to: $ref: '#/components/schemas/ISODate' 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 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' 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' ContractSignRefusedStatusLogbookEntryDetails: type: object required: - reason allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: reason: $ref: '#/components/schemas/RefuseSignContractReason' remark: type: string BaseSubmissionStatusChangedLogbookEntryDetails: type: object description: Change submission logbook entry details required: - type properties: type: $ref: '#/components/schemas/SubmissionStatusChangedLogbookEntryDetailsType' discriminator: propertyName: type 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' 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 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' 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 DocumentLogbookEntry: type: object description: 'DE: Ein Logbucheintrag mit Informationen zu einem hochgeladenen Einreichungsdokument.
EN: A logbook entry holds information about uploading submission document. ' allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: documentName: type: string ISODate: description: 'DE: Datum, Syntax nach RFC 3339
EN: Date according to RFC 3339 ' type: string format: date nullable: true example: '2019-12-29' 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' CounterOfferRevokedLogbookEntry: type: object allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: details: $ref: '#/components/schemas/RevokedCounterOfferLogbookEntryDetails' PhoneType: type: object required: - key properties: key: $ref: '#/components/schemas/PhoneTypeKey' 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' 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' UserId: type: object required: - value description: 'DE: ID des Users.
EN: ID of a user. ' properties: value: type: string RevokedSubmissionLogbookEntry: type: object allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: details: $ref: '#/components/schemas/RevokedSubmissionLogbookEntryDetails' 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 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 CompanyId: type: object required: - value description: 'DE: ID des Unternehmes. EN: ID of the company. ' properties: value: type: string RegularMainProduct: allOf: - $ref: '#/components/schemas/BaseMainProduct' 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' 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' 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 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 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 RevokedSubmissionLogbookEntryDetails: type: object properties: revokeReason: $ref: '#/components/schemas/SubmissionRevokedReason' reasonDescription: 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. 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 PaymentTime: type: object required: - key properties: key: $ref: '#/components/schemas/PaymentTimeKey' SubmissionLogbook: type: object description: 'DE: Enthält alle Logbucheinträge.
EN: Holds submission logbook entries. ' properties: entries: type: array items: $ref: '#/components/schemas/SubmissionLogbookEntry' SubmissionDataViolationSeverity: type: object required: - key properties: key: $ref: '#/components/schemas/SubmissionDataViolationSeverityKey' SuspendedAmortizationOtherProduct: type: object allOf: - $ref: '#/components/schemas/BaseSuspendedAmortizationCombinedProduct' 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 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' 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 LoanContractNumberUpdatedLogbookEntry: type: object allOf: - $ref: '#/components/schemas/BaseLogbookEntry' properties: contracts: type: array items: $ref: '#/components/schemas/ContractInfo' 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' HomePurchaseSavingProvider: type: object required: - key properties: key: $ref: '#/components/schemas/HomePurchaseSavingProviderKey' ExternalProcessingDetail: type: object required: - reason properties: reason: $ref: '#/components/schemas/ExternalProcessingReason' 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' RevokedCounterOfferLogbookEntryDetails: type: object required: - type - id properties: id: $ref: '#/components/schemas/SubmissionCounterOfferId' reason: $ref: '#/components/schemas/RevokeSubmissionCounterOfferReason' BaseInterestMaturity: type: object required: - type properties: type: $ref: '#/components/schemas/InterestMaturityType' discriminator: propertyName: type RejectSubmissionCounterOfferReason: type: object required: - key properties: key: $ref: '#/components/schemas/RejectSubmissionCounterOfferReasonKey' SubmissionStatusChangedLogbookEntryDetailsType: type: string description: 'DE: offenes Enum enthält mögliche Details zum Status der Einreichung von Logbucheinträgen geändert
EN: open ended enum contains possible logbook entry submission status changed details ' example: PROCESSING_PAUSED x-extensible-enum: - CONTRACT_DELIVERED - CONTRACT_SIGNED - CONTRACT_CANCELED - AWAIT_EXTERNAL_PROCESSING - PROCESSING_PAUSED - PROCESSING_RESUMED - REJECTED - CANCELED - REJECTION_REVOKED - INWORK - APPROVED - CONFIRMED - COUNTER_OFFER_CREATED - COUNTER_OFFER_ACCEPTED - COUNTER_OFFER_REJECTED SubmissionProcessingResumedStatusLogbookEntryDetails: type: object allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: status: type: string 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. ' ContractDeliveredStatusLogbookEntryDetails: type: object allOf: - $ref: '#/components/schemas/BaseSubmissionStatusChangedLogbookEntryDetails' properties: contractDeliverDate: $ref: '#/components/schemas/ISODate' contracts: type: array items: $ref: '#/components/schemas/ExtendedContractInfo' parameters: submission-id: name: submissionId in: path required: true schema: type: string description: Id for the requested submission. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT