---
title: "Review the signature dossier"
method: GET
path: "/leases/{lease_id}/annexes/signature-dossier"
tags: ["Lease Annexes"]
---

# Review the signature dossier

`GET /leases/{lease_id}/annexes/signature-dossier`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/annexes/signature-dossier`
- Auth: HTTP bearer

Reviews the documents (annexes) required before a lease can be sent for signature.

Returns, for each expected annex, whether it is mandatory or recommended, whether it
is currently included, and its materialization state (`READY`, `TO_GENERATE`,
`TO_UPLOAD`, or `MISSING`). The top-level `is_ready_to_sign` flag indicates whether
all mandatory annexes are ready.

## Usage Example

```bash
curl -X GET https://api.faireplace.com/api/leases/660e8400-e29b-41d4-a716-446655440001/annexes/signature-dossier \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Response**:
```json
{
  "is_ready_to_sign": false,
  "items": [
    {
      "annex_type": "Dpe",
      "name": "Diagnostic de Performance Énergétique (DPE)",
      "requirement": "MANDATORY",
      "included": true,
      "materialization": "READY",
      "annex_id": "550e8400-e29b-41d4-a716-446655440000"
    },
    {
      "annex_type": "EtatRisques",
      "name": "État des Risques et Pollutions (ERP)",
      "requirement": "MANDATORY",
      "included": false,
      "materialization": "MISSING",
      "annex_id": null
    }
  ]
}
```

## Path parameters

- `lease_id` string, uuid, required

## Response `200`

Signature dossier reviewed successfully

- SignatureDossierResponse: Review of the documents required before a lease can be sent for signature.
  - `is_ready_to_sign` boolean, required: Whether all mandatory annexes are ready and the lease can be signed.
  - `items` SignatureDossierItem[], required: Per-annex review entries.
    - `annex_type` 'NOTICE_INFORMATION' | 'CHARGES_RECUPERABLES' | 'REPARATIONS_LOCATIVES' | 'GRILLE_VETUSTE' | 'INVENTAIRE_MOBILIER' | 'ETAT_DES_LIEUX' | 'DPE' | 'DIAGNOSTIC_PLOMB' | 'DIAGNOSTIC_AMIANTE' | 'DIAGNOSTIC_ELECTRICITE' | 'DIAGNOSTIC_GAZ' | 'ETAT_RISQUES' | 'REGLEMENT_COPROPRIETE' | 'PERMIS_LOUER' | 'ASSURANCE_HABITATION' | 'CAUTIONNEMENT' | 'CUSTOM', required: Type of lease annex (regulatory or supplementary document).
    - `name` string, required: Human-readable name of the annex.
    - `requirement` 'MANDATORY' | 'RECOMMENDED', required: Whether the annex is mandatory or merely recommended.
    - `included` boolean, required: Whether the annex is currently included in the lease dossier.
    - `materialization` 'READY' | 'TO_GENERATE' | 'TO_UPLOAD' | 'MISSING', required: Current materialization state of the annex.
    - `annex_id` string, uuid, nullable: Identifier of the attached annex, if any.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `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)
