Agency Agreement

Template Overview

Template ID: agency-agreement
Version: 1.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 `"Principal"`, `"Agent"`.
`transactionDescription`	`string`	Yes	Description of the transaction Describe the deal the Agent is being engaged to help bring about – what is being bought, sold, raised, leased or arranged, and any value or terms already known. Ex: “The sale of Erf 123 Sandton at a price of not less than R8 million.”
`services`	`array of strings`	Yes	Services to be provided List each service the Agent will provide. Common ones are listed below – add or remove as needed.
`fixedSum`	`boolean`	No	Is the compensation a fixed sum? Choose “Yes” if the Agent will be paid a fixed amount. Choose “No” if the Agent will be paid a percentage of the transaction value.
`fixedSumAmount`	`string`	Conditional	Fee amount Type the fee in numbers and words, including the currency. Example: “R50 000 (fifty thousand Rand)”. Required if `fixedSum` is `true`.
`feePercentage`	`string`	Conditional	Percentage of the transaction value Type the percentage the Agent will earn on the value of the Transaction. Example: “5%” or “7.5%”. Required if `fixedSum` is `false`.
`dispute`	`boolean`	No	How will disputes be resolved? Values: `true` (By Arbitration), `false` (By the court).
`governingLaw`	`string`	No	Which country’s law applies? Choose the country whose laws will be used to read and enforce this contract, and whose courts can hear any dispute. This should normally be the country where the goods are and where the sale happens. Must be a valid value from the Supported Countries list.

Example JSON Payload

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

{
  "templateId": "agency-agreement",
  "data": {
    "parties": [
      {
        "definition": "Principal",
        "isCompany": true,
        "rcName": "Acme Corp",
        "rcAddress": "123 Beta Way",
        "rcCountry": "United States",
        "rcNumber": "12345678",
        "type": "Private Company limited by shares"
      },
      {
        "definition": "Agent",
        "isCompany": false,
        "fullName": "Joshua",
        "address": "789 Alpha Ave",
        "rcCountry": "Nigeria"
      }
    ],
    "transactionDescription": "The sale of Erf 123 Sandton at a price of not less than R8 million.",
    "services": [
      "Sample Services"
    ],
    "fixedSum": true,
    "fixedSumAmount": "ample: R50 000 (fifty thousand Rand)",
    "dispute": true,
    "governingLaw": "Nigeria"
  },
  "format": "pdf"
}