---
title: "Signature contract details"
method: GET
path: "/leases/signatures/contracts/{document_signature_id}"
tags: ["Leases", "Signatures"]
---

# Signature contract details

`GET /leases/signatures/contracts/{document_signature_id}`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/signatures/contracts/{document_signature_id}`
- Auth: HTTP bearer

Retrieves the complete details of a signature contract, including all signers and their statuses

## Path parameters

- `document_signature_id` string, uuid, required

## Response `200`

Details retrieved successfully

- SignatureContractDetails: Full details of a signature contract
  - `document_signature_id` string, uuid, required
  - `lease_id` string, uuid, required
  - `media_id` string, uuid, required: Reference to the media table
  - `status` 'READY' | 'SIGNING' | 'COMPLETED' | 'FAILED' | 'ARCHIVED', required: Status of the document signature process
  - `initiator_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.
  - `initiator_id` string, uuid, required: Initiator ID
  - `event_id` string, required: Unique ID for traceability
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, nullable
  - `signers` SignerDetailsDto[], required
    - `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_phone` string, required
    - `status` 'PENDING' | 'OTP_SENT' | 'SIGNING' | 'COMPLETED' | 'FAILED' | 'EXPIRED', required: Status of an individual signature request
    - `expires_at` string, date-time, required
    - `signed_at` string, date-time, nullable: Date and time of signature
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `legal_name` string, nullable
    - `title` string, nullable
  - `document_url` string, uri, nullable
  - `signed_pdf_url` string, uri, nullable
  - `archive_url` string, uri, nullable: URL of the archived PDF with electronic timestamping

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