---
title: "Process a signature event for a lease"
method: POST
path: "/leases/{lease_id}/signature/events/process"
tags: ["Leases", "Signatures"]
---

# Process a signature event for a lease

`POST /leases/{lease_id}/signature/events/process`

## Request

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

Processes a signature request event received from the notifier function in the context of a specific lease

## Path parameters

- `lease_id` string, uuid, required

## Request body

- SignatureRequestedEvent: Signature request event (format aligned with the notifier function)
  - `base` BaseEvent, required: Base event for Scaleway Topics
    - `event_id` string, required: Unique event ID
    - `event_type` 'SignatureRequested' | 'OtpSent' | 'OtpValidated' | 'SignatureCompleted' | 'DocumentFinalized' | 'NotificationSent' | 'ErrorOccurred', required: Event type
    - `timestamp` string, date-time, required: Date and time of the event
    - `correlation_id` string, nullable: Correlation ID for tracking
    - `tenant_id` string, required: Tenant ID
    - `metadata` object: Additional metadata
  - `document_signature_id` string, uuid, required: Signature process ID
  - `lease_id` string, uuid, required: Lease ID
  - `signer_info` SignerInfo, required: Signer information
    - `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.
    - `phone` string, required: Mobile phone number for OTP
    - `email` string, email, required: Signer email
    - `person_id` string, uuid, nullable: Database person ID
    - `first_name` string, nullable: First name
    - `last_name` string, nullable: Last name
    - `legal_name` string, nullable: Legal name (for companies)
    - `title` string, nullable: Title (Mr., Mrs., etc.)
  - `document_url` string, uri, required: URL of the PDF document to sign
  - `signature_url` string, uri, required: URL to access the signature
  - `expires_at` string, date-time, required: Signature request expiration date

## Response `200`

Event processed successfully

- object
  - `status` string
  - `event_id` string: The processed event ID
  - `document_signature_id` string, uuid
  - `lease_id` string, uuid
  - `signer_email` string, email
  - `signer_type` 'proprietaire' | 'locataire' | 'agent_immobilier' | 'caution': 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.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `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)