Tenancy Agreement

Template Overview

Template ID: tenancy-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, it must contain exactly 2 entities. Uses the standard Parties Schema with one additional required field: • `definition` (`string`): Must be either `"Landlord"` or `"Tenant"`.
`propertyDescription`	`string`	No	A description of the property being leased (e.g., "A 3 bedroom flat").
`location`	`string`	No	The physical address of the property.
`currency`	`string`	No	The currency used for rent and service payments. Options: `"NGN"`, `"USD"`, `"GBP"`, `"ZAR"`, `"Others"`
`customCurrency`	`string`	Conditional	The custom currency identifier. Required if `currency` is set to `"Others"`.
`rentAmount`	`number`	No	The rent amount corresponding to the payment frequency.
`paymentFrequency`	`string`	No	How often the rent is paid. Options: `"Monthly"`, `"Quarterly"`, `"Annually"`
`service`	`boolean`	No	Indicates whether a service charge applies to the property.
`serviceCharge`	`number`	Conditional	The amount of the service charge. Required if `service` is `true`.
`serviceChargeFrequency`	`string`	Conditional	How often the service charge is paid. Options: `"Monthly"`, `"Quarterly"`, `"Annually"` Required if `service` is `true`.
`commencementDate`	`string`	No	The date the tenancy begins (Format: `YYYY-MM-DD`). Can be backdated or postdated.
`rentDuration`	`number`	Yes	The duration of the tenancy in months. (Minimum: `1`)
`SDAmount`	`number`	No	The total amount of the security deposit.
`governingLaw`	`string`	No	The legal jurisdiction whose laws govern the agreement. Limited Options: `"Nigeria"`, `"South Africa"`, `"Botswana"`, `"United Kingdom"`, `"Kenya"`, `"Mozambique"`, `"UAE"`

Example JSON Payload

Here is an example of a properly formatted data object for the Tenancy Agreement template. Note the strict requirement of exactly two parties and the addition of the definition field for each party.

{
  "templateId": "tenancy-agreement",
  "data": {
    "parties": [
      {
        "definition": "Landlord",
        "isCompany": true,
        "rcName": "Prime Real Estate Ltd",
        "rcAddress": "100 Victoria Island, Lagos",
        "rcCountry": "Nigeria",
        "rcNumber": "RC9876543",
        "type": "Private Company limited by shares"
      },
      {
        "definition": "Tenant",
        "isCompany": false,
        "fullName": "Joshua",
        "address": "42 Campus Drive",
        "rcCountry": "Nigeria"
      }
    ],
    "propertyDescription": "A newly renovated 2-bedroom apartment",
    "location": "Plot 15, Maitama, Abuja",
    "currency": "NGN",
    "rentAmount": 2500000,
    "paymentFrequency": "Annually",
    "service": true,
    "serviceCharge": 150000,
    "serviceChargeFrequency": "Quarterly",
    "commencementDate": "2026-06-01",
    "rentDuration": 12,
    "SDAmount": 300000,
    "governingLaw": "Nigeria"
  },
  "format": "pdf"
}