Loan Agreement

Template Overview

Template ID: loan-agreement
Version: 2.0.0

To generate this document, pass the structured data described below into the data property of the /api/v1/documents/generate endpoint.

Data Payload Schema

Field	Type	Requirement	Description & Details
`parties`	`array of objects`	Yes	The entities entering into the agreement. For this template, must contain exactly 2 entities. Uses the standard Parties Schema. Each party also takes a `definition` field: one of `"Lender"`, `"Borrower"`.
`governingLaw`	`string`	No	What is the governing law of this Agreement? Must be a valid value from the Supported Countries list.
`currency`	`string`	No	What is the loan currency? Options: `"NGN"`, `"USD"`, `"GBP"`, `"ZAR"`, `"Others"`
`customCurrency`	`string`	Conditional	Insert the appropriate currency Required if `currency` is `"Others"`.
`loanAmount`	`number`	No	What is the loan amount? Ex: 100,000. Note: If the Borrower is a South African Small Business (turnover < R1m) and this amount is under R250,000, the National Credit Act applies. Ex: 100,000
`interestRate`	`string`	No	What is the interest rate of the loan (%)? Insert the interest rate per year being charged on the loan. Ex: 10. NOTE: Under SA Law (NCA), interest is capped. For unsecured loans, the max is generally (Repo Rate x 2.2) + 20%. Additionally, the 'In Duplum' rule applies: total unpaid interest/fees can never exceed the outstanding capital sum.
`loanPurpose`	`string`	No	Purpose of the Loan Describe what the loan is for in a sentence or 2. Ex: Funding the business activities of the Borrower
`repaymentDate`	`number`	No	Insert Maturity Date (months) This is the number of months after the payment date (and moratorium if applicable) that all money owed under the loan should have been fully repaid to the lender and is typically called the Maturity Date. Ex: 10 months
`moratorium`	`boolean`	No	Will there be a moratorium? A moratorium is a period of time during the term of the loan, where repayment of the principal is suspended
`moratoriumDuration`	`string`	Conditional	How long is the moratorium (months)? Ex: 3 months Required if `moratorium` is `true`.
`loanRepayment`	`string`	No	How will the loan be repaid? Options: `"Monthly"`, `"Quarterly"`, `"Bi-annual"`, `"Maturity Date"`
`duties`	`array of strings`	No	Add conditions for the loan These are the conditions that need to be fulfilled before the borrower can receive the loan. Ex: The signing of this Loan Agreement
`dispute`	`boolean`	No	How do you want your disputes solved? Courts are slower. Arbitration is faster but expensive. Note: In South Africa, lenders MUST issue a Section 129 Default Notice 10 business days before taking any legal action, regardless of this selection. Courts are typically slower and cheaper. While arbitration is a generally faster but more expensive dispute resolution process. Values: `true` (By Arbitration), `false` (By the court).

Example JSON Payload

Here is an example of a properly formatted data object for the Loan Agreement template.

{
  "templateId": "loan-agreement",
  "data": {
    "parties": [
      {
        "definition": "Lender",
        "isCompany": true,
        "rcName": "Acme Corp",
        "rcAddress": "123 Beta Way",
        "rcCountry": "United States",
        "rcNumber": "12345678",
        "type": "Private Company limited by shares"
      },
      {
        "definition": "Borrower",
        "isCompany": false,
        "fullName": "Joshua",
        "address": "789 Alpha Ave",
        "rcCountry": "Nigeria"
      }
    ],
    "governingLaw": "Nigeria",
    "currency": "NGN",
    "loanAmount": 100000,
    "interestRate": "10",
    "loanPurpose": "Funding the business activities of the Borrower",
    "repaymentDate": 10,
    "moratorium": true,
    "moratoriumDuration": "3 months",
    "loanRepayment": "Monthly",
    "duties": [
      "The signing of this Loan Agreement"
    ],
    "dispute": true
  },
  "format": "pdf"
}