---
title: "Generate a guarantor act (PDF)"
method: POST
path: "/public/tools/cautionnement/generate"
tags: ["Public Tools"]
---

# Generate a guarantor act (PDF)

`POST /public/tools/cautionnement/generate`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/public/tools/cautionnement/generate`
- Auth: none required

Generates a guarantor act (acte de cautionnement) PDF. Art. 22-1 Loi 89-462
and Art. 2297 Code civil (the maximum guaranteed amount must be given in
figures AND words).

Public, unauthenticated tool. Returns `application/pdf`.

## Request body

- CautionnementGenerateRequest: Guarantor act (acte de cautionnement) generator. Art. 22-1 Loi 89-462 and Art. 2297 Code civil (amount in figures AND words is mandatory).
  - `caution` CautionDto, required
    - `title` string
    - `first_name` string
    - `last_name` string, required
    - `address` string, required
    - `postal_code` string, required
    - `city` string, required
    - `birth_date` string, date, nullable
    - `birth_place` string
  - `tenant` DocLesseeDto, required: Tenant identity (name only) for a generated document.
    - `title` string
    - `first_name` string
    - `last_name` string, required
  - `owner` DocOwnerDto, required: Landlord identity for a generated document.
    - `title` string
    - `first_name` string
    - `last_name` string, required
    - `legal_name` string: Company / legal name (e.g. an SCI).
    - `address` string, required
    - `postal_code` string, required
    - `city` string, required
  - `property` DocPropertyDto, required: Rented dwelling for a generated document.
    - `address` string, required
    - `postal_code` string, required
    - `city` string, required
  - `engagement_type` 'SIMPLE' | 'SOLIDAIRE', required
  - `duration_type` 'DETERMINEE' | 'INDETERMINEE', required
  - `duration_end` string, date, nullable
  - `max_amount` string, required: Maximum guaranteed amount in figures (mandatory, Art. 2297 CC).
  - `max_amount_letters` string, required: Maximum guaranteed amount in words (mandatory, Art. 2297 CC).
  - `rent_amount` string, required
  - `charges_amount` string, nullable
  - `revision` string, nullable
  - `lease_start_date` string, date, nullable
  - `lease_type` string, nullable
  - `signature_date` string, date, nullable
  - `signature_city` string, nullable

## Response `200`

The generated guarantor act PDF.

## Other responses

- `400`: Bad request
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)