---
title: "Get signature status of a lease for the tenant"
method: GET
path: "/lessee/leases/{id}/signature/status"
tags: ["Lessees", "Leases", "Signatures"]
---

# Get signature status of a lease for the tenant

`GET /lessee/leases/{id}/signature/status`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/lessee/leases/{id}/signature/status`
- Auth: HTTP bearer

Retrieves the signature status of a specific lease for the authenticated tenant.

Returns:
- The signature document status (`READY`, `SIGNING`, `COMPLETED`, `FAILED`, `ARCHIVED`)
- The signed media ID (`signed_media_id`) if the document is signed, allowing retrieval of the signed PDF URL
- The details of all associated signature requests
- Information about the signers and their status

## Required permissions
- `lessee:leases:read`

## Path parameters

- `id` string, uuid, required

## Response `200`

Signature status retrieved successfully

- object
  - `lease_id` string, uuid: Lease ID
  - `document_signature_id` string, uuid: Signature document ID
  - `status` 'READY' | 'SIGNING' | 'COMPLETED' | 'FAILED' | 'ARCHIVED': Signature document status
  - `signed_media_id` string, uuid, nullable: Signed PDF media ID (available after full signature completion)
  - `requests` SignatureRequestSummary[]: Signature requests list
    - `id` string, uuid, required: Signature request ID
    - `signer_type` 'proprietaire' | 'locataire' | 'agent_immobilier' | 'caution', required: Who is signing. **Always lowercase** on the wire. `caution` is deliberately distinct from `locataire`: a surety does not sign the lease, they sign their own surety deed, on which they must themselves write the mention required by article 2297 of the Civil Code: without it their undertaking is void.
    - `signer_email` string, email, required: Signer email
    - `status` 'PENDING' | 'OTP_SENT' | 'SIGNING' | 'COMPLETED' | 'FAILED' | 'EXPIRED', required: Status of an individual signature request
    - `expires_at` string, date-time, required: Request expiration date

## Other responses

- `401`: Unauthorized
- `403`: Unauthorized - The user is not a tenant of this lease
- `404`: Lease not found or no signature document initiated
- `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)