{"name":"firma.de Darlehensvertrag-API","version":1,"description":"Erstellt einen Darlehensvertrag nach deutschem Recht aus den festen Klauseln des Darlehensvertrag-Generators von firma.de: Gesellschafterdarlehen an die GmbH oder UG, Darlehen der Gesellschaft an ihren Gesellschafter, Privatdarlehen (auch unter Angehörigen) und Darlehen zwischen Unternehmen. Die Antwort enthält den Vertragstext (offene Angaben als [Platzhalter]), den Zins- und Tilgungsplan nach der deutschen Zinsmethode 30/360, die Hinweise des Generators zu Verbraucherkreditrecht, verdeckter Gewinnausschüttung, Schenkungsteuer und Insolvenz, Buchungssätze in SKR03 und SKR04 und einen Link, der den Entwurf im Generator öffnet: Dort bearbeiten beide Seiten ihn weiter, unterschreiben und laden PDF oder Word herunter. Kostenlos, ohne Schlüssel.","privacy":"Die API rechnet auf dem Server und speichert nichts: keine Eingaben, keine Verträge. Antworten mit Namen, Anschriften oder IBAN landen auch in keinem gemeinsamen Cache. Für solche Angaben nimm trotzdem POST: Die Parameter einer GET-Adresse können wie jede Adresse in Zugriffsprotokollen von Hosting, Proxys, Browsern und Agenten landen.","openapi":"https://www.firma.de/api/darlehensvertrag/openapi.json","builder":"https://www.firma.de/darlehensvertrag/","builderLink":"builderUrl öffnet den Entwurf im Generator: https://www.firma.de/darlehensvertrag/#dv=<base64url(JSON)>. Das JSON enthält die Felder, die vom leeren Entwurf abweichen, verschachtelt wie draft, und v: 1. Der Teil nach # erreicht unseren Server nicht; der Generator liest ihn im Browser, nimmt ihn aus der Adresszeile und speichert den Entwurf nur in diesem Browser. Ohne date im Aufruf trägt der Link kein Datum, der Generator setzt dann den Tag, an dem er geöffnet wird; ein leeres date bleibt leer (Datum von Hand). Denselben Link nimmt der Parameter draft entgegen.","consumerCredit":"Leiht ein Unternehmen, auch die eigene GmbH oder UG, einer Privatperson Geld für private Zwecke, ist das ein Verbraucherdarlehen (§§ 491 ff. BGB), ab 20.11.2026 auch zinslos. Pflichtangaben, vorvertragliche Information und Widerrufsbelehrung kann kein Muster passend zum Fall liefern, deshalb gibt es dafür keinen Vertragstext: Die Antwort kommt mit HTTP 200, blocked: true, contract: null und blockedReason; Hinweise, Plan, Buchungssätze und der Generator-Link kommen trotzdem. Das betrifft scenario=loanToShareholder mit einer Person als Darlehensnehmer und scenario=business, wenn ein Unternehmen einer Person für private Zwecke leiht (borrowerPurpose=private, der Standard; nimmt die Person das Geld für ihr Geschäft auf, borrowerPurpose=business setzen).","units":"Beträge in Euro, Zinsen in Prozent pro Jahr (5 heißt 5 % p. a.), Daten als YYYY-MM-DD; TT.MM.JJJJ und heute gehen auch. Zahlen dürfen deutsch geschrieben sein: 50.000, 50.000,00, 4,5, 50k, 1,5 Mio. Auswahlwerte gehen auch auf Deutsch: zinslos, fest, variabel, endfällig, Raten, Annuität, unbefristet, Bürgschaft, Abtretung, monatlich, jährlich …","statuses":"200 auch für unvollständige (complete: false) und gesperrte (blocked: true) Entwürfe: Der Generator ist gelaufen. 400 mit problems je Feld bei ungültigen Werten oder unbekannten Parametern; Tracking-Parameter wie utm_source zählen nicht. 413 über 20000 Bytes, 429 bei mehr als 120 Aufrufen pro Minute.","get":{"examples":{"shareholderLoan":{"description":"Gesellschafterdarlehen mit Rangrücktritt, endfällig nach drei Jahren.","url":"https://www.firma.de/api/darlehensvertrag/?scenario=shareholderLoan&amount=50000&rate=5&disbursementDate=2026-11-15&maturity=2029-11-15&lender=Anna+Schmidt&lenderAddress=Kastanienallee+12,+10435+Berlin&borrower=Lumio+GmbH&borrowerAddress=Rosenthaler+Stra%C3%9Fe+40,+10178+Berlin&borrowerRepresentative=Anna+Schmidt,+Gesch%C3%A4ftsf%C3%BChrerin&managingDirector=true&subordination=true&place=Berlin"},"familyLoan":{"description":"Privatdarlehen unter Angehörigen mit 24 Monatsraten, als Markdown.","url":"https://www.firma.de/api/darlehensvertrag/?scenario=private&relatives=ja&lender=Karl+Schmidt&borrower=Anna+Schmidt&amount=12.000&rate=3&disbursementDate=15.11.2026&repayment=annuity&count=24&firstRate=15.12.2026&place=Berlin&format=md"},"consumerCredit":{"description":"Die GmbH leiht ihrem Gesellschafter privat Geld: gesperrt, ohne Vertragstext.","url":"https://www.firma.de/api/darlehensvertrag/?scenario=loanToShareholder&amount=20k&rate=5&disbursementDate=2026-12-01&maturity=2028-12-01&lender=Lumio+GmbH&borrower=Anna+Schmidt"}},"parameters":{"scenario":{"description":"Wer leiht wem. shareholderLoan: ein Gesellschafter (Person oder Holding) leiht seiner GmbH oder UG. loanToShareholder: die GmbH oder UG leiht ihrem Gesellschafter. private: Privatperson an Privatperson. business: zwischen Unternehmen oder zwischen Person und Unternehmen, ohne Gesellschafterbeziehung.","example":"shareholderLoan","field":"scenario","type":"enum","values":["shareholderLoan","loanToShareholder","private","business"]},"lender":{"description":"Name des Darlehensgebers: voller Name der Person oder Firma mit Rechtsform.","example":"Anna Schmidt","field":"lender.name","type":"text","maxLength":120,"aliases":["lenderName"]},"lenderKind":{"description":"Art des Darlehensgebers. Das Szenario setzt sie; ändern lässt sie sich, wo das passt: bei shareholderLoan eine Holding als Gesellschafter, bei business jede Seite.","example":"person","field":"lender.kind","type":"enum","values":["person","company"]},"lenderAddress":{"description":"Anschrift des Darlehensgebers in einer Zeile: Straße und Hausnummer, PLZ und Ort.","example":"Kastanienallee 12, 10435 Berlin","field":"lender.address","type":"text","maxLength":200},"lenderRegister":{"description":"Nur Unternehmen: Registergericht und Nummer.","example":"Amtsgericht Berlin (Charlottenburg), HRB 123456","field":"lender.register","type":"text","maxLength":120},"lenderRepresentative":{"description":"Nur Unternehmen: wer für den Darlehensgeber unterschreibt, mit Funktion.","example":"Anna Schmidt, Geschäftsführerin","field":"lender.representative","type":"text","maxLength":160},"borrower":{"description":"Name des Darlehensnehmers: voller Name der Person oder Firma mit Rechtsform.","example":"Lumio GmbH","field":"borrower.name","type":"text","maxLength":120,"aliases":["borrowerName"]},"borrowerKind":{"description":"Art des Darlehensnehmers. Das Szenario setzt sie; ändern lässt sie sich, wo das passt: bei loanToShareholder eine Holding als Gesellschafter, bei business jede Seite.","example":"company","field":"borrower.kind","type":"enum","values":["person","company"]},"borrowerAddress":{"description":"Anschrift des Darlehensnehmers in einer Zeile: Straße und Hausnummer, PLZ und Ort.","example":"Rosenthaler Strasse 40, 10178 Berlin","field":"borrower.address","type":"text","maxLength":200},"borrowerRegister":{"description":"Nur Unternehmen: Registergericht und Nummer.","example":"Amtsgericht Berlin (Charlottenburg), HRB 123456","field":"borrower.register","type":"text","maxLength":120},"borrowerRepresentative":{"description":"Nur Unternehmen: wer für den Darlehensnehmer unterschreibt, mit Funktion.","example":"Anna Schmidt, Geschäftsführerin","field":"borrower.representative","type":"text","maxLength":160},"borrowerPurpose":{"description":"Bei business mit einer Person als Darlehensnehmer: private (Standard; privat, dann Verbraucherdarlehen) oder business (für ein bestehendes Geschäft oder eine selbständige Tätigkeit).","example":"business","field":"borrowerPurpose","type":"enum","values":["private","business"]},"managingDirector":{"description":"Gesellschafter-Szenarien: Der Gesellschafter ist eine Person und zugleich Geschäftsführer der Gesellschaft (§ 181 BGB, § 43a GmbHG).","example":"true","field":"relation.managingDirector","type":"boolean"},"signer":{"description":"Mit managingDirector: sameExempt, er unterschreibt auch für die Gesellschaft und ist von § 181 BGB befreit; otherDirector, ein anderer Geschäftsführer unterschreibt für sie.","example":"sameExempt","field":"relation.signer","type":"enum","values":["sameExempt","otherDirector"]},"formation":{"description":"Bei shareholderLoan: Die Gesellschaft ist notariell gegründet, aber noch nicht eingetragen (in Gründung).","example":"false","field":"relation.formation","type":"boolean"},"relatives":{"description":"Bei private: Die Parteien sind Angehörige (§ 15 AO).","example":"true","field":"relation.relatives","type":"boolean"},"amount":{"description":"Darlehensbetrag in Euro.","example":"50000","field":"amount","type":"number","min":1,"max":100000000},"disbursement":{"description":"Wie das Geld fließt: transfer, wird überwiesen; paid, ist schon ausgezahlt; onCall, auf Abruf.","example":"transfer","field":"disbursement.mode","type":"enum","values":["transfer","paid","onCall"]},"disbursementDate":{"description":"Bei transfer: Auszahlung bis; bei paid: ausgezahlt am; bei onCall: abrufbar bis. Ab hier läuft der Plan.","example":"2026-11-15","field":"disbursement.date","type":"date","aliases":["disbursed"]},"iban":{"description":"Optional: IBAN des Darlehensnehmers für die Überweisung; sonst zahlt der Darlehensgeber auf ein benanntes Konto.","example":"DE89 3704 0044 0532 0130 00","field":"disbursement.iban","type":"text","maxLength":42},"interest":{"description":"none, zinslos; fixed, fester Zins (Standard); variable, Basiszinssatz plus Aufschlag. margin ohne interest setzt variable.","example":"fixed","field":"interest.mode","type":"enum","values":["none","fixed","variable"]},"rate":{"description":"Bei fixed: Zins in Prozent pro Jahr.","example":"5","field":"interest.rate","type":"number","min":0,"max":20},"margin":{"description":"Bei variable: Prozentpunkte über dem Basiszinssatz nach § 247 BGB (derzeit 1,52 %).","example":"2,5","field":"interest.margin","type":"number","min":0,"max":15},"interestPayment":{"description":"Wann Zinsen fällig sind, wenn das Darlehen endfällig oder unbefristet ist: monthly, quarterly, yearly (Standard) oder maturity, mit der Rückzahlung. Bei Raten sind sie mit jeder Rate fällig.","example":"yearly","field":"interest.payment","type":"enum","values":["monthly","quarterly","yearly","maturity"]},"repayment":{"description":"bullet, auf einmal am Fälligkeitstag (Standard); installments, Raten mit gleicher Tilgung plus Zinsen; annuity, gleiche Raten mit Zinsen; open, unbefristet bis zur Kündigung.","example":"bullet","field":"repayment.mode","type":"enum","values":["bullet","installments","annuity","open"]},"maturity":{"description":"Bei bullet: Tag der Rückzahlung.","example":"2029-11-15","field":"repayment.maturityDate","type":"date","aliases":["maturityDate"]},"firstRate":{"description":"Bei installments und annuity: Fälligkeit der ersten Rate.","example":"2026-12-15","field":"repayment.firstDate","type":"date","aliases":["firstDate"]},"count":{"description":"Bei installments und annuity: Anzahl der Raten.","example":"24","field":"repayment.count","type":"number","min":1,"max":600,"integer":true},"frequency":{"description":"Bei installments und annuity: wie oft eine Rate fällig ist (Standard monthly).","example":"monthly","field":"repayment.frequency","type":"enum","values":["monthly","quarterly","yearly"]},"notice":{"description":"Bei open: Kündigungsfrist in Monaten für beide Seiten (Standard 3, § 488 Abs. 3 BGB).","example":"3","field":"repayment.noticeMonths","type":"number","min":1,"max":24,"integer":true,"aliases":["noticeMonths"]},"earlyRepayment":{"description":"Vorzeitige Rückzahlung jederzeit, ganz oder in Teilen, ohne Entschädigung (Standard true).","example":"true","field":"earlyRepayment","type":"boolean"},"security":{"description":"Sicherheit: none (Standard); guarantee, Bürgschaft; assignment, Sicherungsabtretung; other, eine andere.","example":"guarantee","field":"security.mode","type":"enum","values":["none","guarantee","assignment","other"]},"securityText":{"description":"Bei guarantee: Name und Anschrift des Bürgen; bei assignment: die abgetretenen Forderungen; bei other: die Sicherheit in Worten.","example":"Maria Schmidt, Kastanienallee 12, 10435 Berlin","field":"security.text","type":"text","maxLength":300},"subordination":{"description":"Qualifizierter Rangrücktritt des Darlehensgebers; nur wenn eine Gesellschaft das Geld bekommt.","example":"true","field":"subordination","type":"boolean"},"reporting":{"description":"Die Gesellschaft, die das Geld bekommt, schickt dem Darlehensgeber jedes Jahr ihren Jahresabschluss.","example":"false","field":"reporting","type":"boolean"},"approval":{"description":"Die Gesellschafterversammlung hat dem Vertrag zugestimmt; nur angeben, wenn es den Beschluss gibt.","example":"false","field":"shareholderApproval","type":"boolean","aliases":["shareholderApproval"]},"jurisdiction":{"description":"Gerichtsstand am Sitz des Darlehensgebers; gilt nur zwischen Kaufleuten wie zwei GmbHs (§ 38 ZPO).","example":"false","field":"jurisdiction","type":"boolean"},"purpose":{"description":"Optional: wofür das Geld ist.","example":"Betriebsmittel","field":"purpose","type":"text","maxLength":300},"place":{"description":"Ort der Unterschrift.","example":"Berlin","field":"signing.place","type":"text","maxLength":80,"aliases":["signingPlace"]},"date":{"description":"Datum der Unterschrift; ohne Angabe heute (Europe/Berlin).","example":"2026-11-10","field":"signing.date","type":"date","aliases":["signingDate"]},"draft":{"description":"Ein Link des Generators oder nur der Teil nach #dv= als Ausgangspunkt; weitere Parameter ändern ihn. In einer GET-Adresse das # als %23 schreiben, sonst kommt der Entwurf nicht an. Bei POST auch ein Entwurf als Objekt, etwa draft aus einer früheren Antwort.","example":"https://www.firma.de/darlehensvertrag/#dv=…","type":"text"},"format":{"description":"json (Standard) oder md: Vertrag, Plan und Hinweise als Markdown.","example":"md","type":"enum","values":["json","md"]}}},"post":{"contentType":"application/json","description":"POST mit JSON in der Form des Entwurfs (wie draft in der Antwort): verschachtelt, etwa interest: { mode, rate }, oder mit denselben flachen Namen wie bei GET. Fehlende Felder und null lassen den Standard stehen, \"\" leert ein Text-, Datums- oder Zahlenfeld. format und draft gehen auch hier; draft darf ein Generator-Link oder ein Entwurf als Objekt sein, etwa draft aus einer früheren Antwort.","example":{"scenario":"shareholderLoan","amount":50000,"lender":{"name":"Anna Schmidt","address":"Kastanienallee 12, 10435 Berlin"},"borrower":{"name":"Lumio GmbH","address":"Rosenthaler Straße 40, 10178 Berlin","register":"Amtsgericht Berlin (Charlottenburg), HRB 123456","representative":"Anna Schmidt, Geschäftsführerin"},"relation":{"managingDirector":true},"disbursement":{"mode":"transfer","date":"2026-11-15"},"interest":{"mode":"fixed","rate":5,"payment":"yearly"},"repayment":{"mode":"bullet","maturityDate":"2029-11-15"},"subordination":true,"signing":{"place":"Berlin","date":"2026-11-10"},"format":"json"}},"answer":{"basisRate":"Basiszinssatz nach § 247 BGB in Prozent und seit wann er gilt; damit rechnet ein variabler Zins.","blocked":"true, wenn das Muster für den Fall nicht reicht (Verbraucherdarlehen): Dann ist contract null.","blockedReason":"Warum es keinen Vertragstext gibt und wer weiterhilft; sonst null.","bookkeeping":"Buchungssätze (Soll an Haben) für die Gesellschaft, die bucht, mit Kontonummern in SKR03 und SKR04 und Beträgen aus dem Plan, die Zinsen je Geschäftsjahr und steuerliche Hinweise. Zwischen Privatpersonen nur Hinweise; null, solange kein scenario gewählt ist. Eine Kontonummer null heißt: Nummer laut Kontenplan der Kanzlei.","builderUrl":"Öffnet den Entwurf im Generator von firma.de zum Bearbeiten, Unterschreiben und Herunterladen.","checks":"Hinweise zum Vertrag, die ernstesten zuerst. level stop: nicht mit diesem Muster; warn: prüfen, die Bedingungen bergen ein Risiko; info: gut zu wissen. law nennt die Norm, lawUrl den Gesetzestext, cta den passenden Berater.","complete":"true, wenn keine Angabe mehr fehlt.","contract":"Der Vertrag als Text und als Markdown; offene Angaben stehen als [Platzhalter] darin.","disclaimer":"Ein Muster, keine Rechts- oder Steuerberatung im Einzelfall.","draft":"Der Entwurf, wie er in den Vertrag eingeht, geprüft und vervollständigt. Als POST-Body oder draft zurückgeschickt, ändert er sich mit weiteren Feldern.","missing":"Was der Vertrag noch als Platzhalter zeigt, mit deutscher Bezeichnung.","schedule":"Zins- und Tilgungsplan: jede Fälligkeit mit Zahlung, Zinsen, Tilgung und Restschuld, die Zinsen je Kalenderjahr und die Summen. Ohne feste Termine (auf Abruf, unbefristet) oder solange Angaben fehlen nur reason und message.","stand":"Datum, zu dem Klauseln, Hinweise und Zahlen zuletzt gegen Gesetz und Rechtsprechung geprüft wurden."},"stand":"2026-10-27","disclaimer":"Muster und Erläuterungen, keine Rechts- oder Steuerberatung im Einzelfall. Maßgeblich sind euer Vertrag, eure Satzung und das Gesetz."}