---
title: "Generate an inspection report (PDF)"
method: POST
path: "/public/tools/etat-des-lieux/generate"
tags: ["Public Tools"]
---

# Generate an inspection report (PDF)

`POST /public/tools/etat-des-lieux/generate`

## Request

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

Generates a semi-filled, print-and-complete inspection report (état des
lieux) PDF, conform to decree 2016-382.

Accepts the structured payload below, or a simplified payload for AI agents
(fields like `landlord_name`, `property_type`, `tenant_names`, `rooms`);
the handler auto-detects and converts it.

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

## Request body

- EdlGenerateRequest: Inspection report (état des lieux) generator. Produces a semi-filled, print-and-complete document (decree 2016-382). The endpoint also accepts a simplified payload (for AI agents) with fields such as `landlord_name`, `property_type`, `tenant_names`, `rooms`; the handler auto-detects and converts it. The structured form below is the primary contract.
  - `edl_type` 'entree' | 'sortie', required: "entree" (or "entrée") or "sortie".
  - `generation_date` string, date, required: Generation date (= physical visit date).
  - `bailleur` EdlPartyDto, required
    - `nom_prenom` string, required
    - `adresse` string, required
    - `code_postal` string, required
    - `ville` string, required
    - `telephone` string
    - `email` string
  - `locataires` EdlPartyDto[], required
    - `nom_prenom` string, required
    - `adresse` string, required
    - `code_postal` string, required
    - `ville` string, required
    - `telephone` string
    - `email` string
  - `logement` EdlPropertyDto, required
    - `adresse` string, required
    - `code_postal` string, required
    - `ville` string, required
    - `nom` string
    - `surface` string
    - `type_bien` string: T1..T6, Maison, Studio.
    - `etage` string
    - `batiment` string
    - `numero_lot` string
  - `is_meuble` boolean: When true, the per-room furniture inventory is rendered.
  - `bail_debut` string, date, nullable
  - `bail_fin` string, date, nullable
  - `pieces` EdlRoomDto[], required
    - `nom` string, required
    - `surface` string
    - `elements` EdlRoomElementDto[]: Structural element grid. If absent or empty the service fills a default grid at "good" condition.
      - `element_type` string, required
      - `condition` string: Defaults to "good" server-side.
      - `comment` string
    - `mobilier` EdlMobilierItemDto[]: Furniture inventory (used only when `is_meuble` is true).
      - `nom` string, required
      - `quantite` integer, required
      - `condition` string
      - `notes` string
  - `clefs` EdlKeyDto[]
    - `libelle` string, required
    - `quantite` integer, required
    - `etat` string
  - `lieu_signature` string, required

## Response `200`

The generated inspection report 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)