---
title: "Initiate eIDAS signature"
method: POST
path: "/leases/{lease_id}/condition-reports/{report_id}/initiate-signature"
tags: ["Condition Reports"]
---

# Initiate eIDAS signature

`POST /leases/{lease_id}/condition-reports/{report_id}/initiate-signature`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/condition-reports/{report_id}/initiate-signature`
- Auth: HTTP bearer

Initiate the contradictory electronic signature process for the condition report.

**Prerequisites:**
- Report must be in `COMPLETED` status (observations locked)
- `document_url` must be set (PDF generated via endpoint #11)

**Flow (reuses existing signature system):**
1. Uploads the filled PDF to Media system (security_level = `Critical`, entity_type = `ConditionReport`)
2. Creates a `DocumentSignature` record with `document_type = "CONDITION_REPORT"`
3. Creates `SignatureRequest` for the owner (`Proprietaire`) and each tenant (`Locataire`)
4. Sends signature requests to DO Global (external eIDAS provider)
5. Publishes notification events (same pattern as lease/amendment signatures)
6. Stores `document_signature_id` on the condition report

Each party signs via OTP (same flow as lease signatures).

**Legal context:** Art. 3-2 loi ALUR: L'état des lieux est établi contradictoirement.
eIDAS art. 25: La signature électronique avancée constitue une preuve recevable.

**Permissions required:** `leases:write`

## Path parameters

- `lease_id` string, uuid, required
- `report_id` string, uuid, required

## Request body

- object
  - `initiator_id` string, uuid, required: UUID of the person initiating the signature (owner or agent)
  - `initiator_signer_type` 'PROPRIETAIRE' | 'AGENT_IMMOBILIER': Signer type of the initiator (defaults to PROPRIETAIRE)

## Response `200`

Signature process initiated

- object
  - `document_signature_id` string, uuid
  - `media_id` string, uuid: PDF uploaded to media system (Critical security level)
  - `signature_requests` object[]
    - `signer_type` 'PROPRIETAIRE' | 'LOCATAIRE'
    - `signer_email` string
    - `status` 'PENDING'
  - `status` 'SIGNING'

## Other responses

- `400`: Report not in COMPLETED status or PDF not generated
- `401`: Unauthorized
- `403`: Forbidden

---

[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)
