What is the FairePlace API?

FairePlace is a REST API for property management in France. It lets you create and manage properties and leases, generate Loi ALUR-compliant lease PDFs, collect eIDAS-compliant electronic signatures, and run French rental-law compliance checks (IRL rent revision, encadrement des loyers, deposit limits), through 574 endpoints at https://api.faireplace.com/api.

Does the FairePlace API support legally binding electronic signatures?

Yes. FairePlace provides eIDAS-compliant electronic signatures with OTP (SMS/email) verification and a signed proof archive, so you can collect legally binding lease signatures without any third-party signature service.

Is the FairePlace API compliant with French rental law?

Yes. Compliance is built in: Loi ALUR lease templates, IRL rent indexation, encadrement des loyers (rent control) checks, zone tendue detection, security-deposit limits and mandatory annexes are validated automatically on every lease.

How do I authenticate with the FairePlace API?

Authentication uses an API key passed as a Bearer token: 'Authorization: Bearer fp_your_api_key'. Requests are isolated per organization (tenant). See https://developers.faireplace.com/quickstart/authentication.

How much does the FairePlace API cost?

Billing is credit-based: 1 credit = 1 eIDAS signature, charged when a signature is launched. The free Gratuit tier includes unlimited lease PDFs and 5 properties, with signatures at 4.90 EUR each. Paid plans bundle signatures and unlock API access: Starter (14.90 EUR/month), Pro (34.90 EUR/month, read API access), Business (69.90 EUR/month, full API access + SSO/SAML), and Sur Mesure (from 99 EUR/month, white-label). No commitment.

Property Management API for France

Developer documentation

The API for French property management

faire place à ce qui compte

Create leases, collect advanced electronic signatures (eIDAS), and keep every rent compliant with French law. From API key to signed lease PDF in six calls.

Create your first lease API reference

Your first call

# List the buildings on your account
curl https://api.faireplace.com/api/places \
  -H "Authorization: Bearer $FP_API_KEY"

What the API actually does for you

French rental law is the hard part. It is also the part you do not have to write.

Leases that hold up

Generate a lease PDF that follows the loi ALUR, then collect advanced electronic signatures with OTP verification. No third-party signature service to plug in.

See the workflow

Compliance, checked on write

Rent caps, IRL revision, deposit ceilings, tense-zone rules. Validated when the lease is created, not left to your code to rediscover.

How compliance works

The whole lifecycle

Buildings, apartments, rooms, meters, charges, receipts, amendments, termination. 574 operations, one consistent REST surface.

Explore the API

From zero to signed lease in six calls

Every call below is copy-paste ready. Replace the placeholders and run it.

Code
# 1. Set your API key
export FP_API_KEY="fp_your_api_key_here"

# 2. Create an owner
curl -X POST https://api.faireplace.com/api/owners \
  -H "Authorization: Bearer $FP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jean", "last_name": "Dupont", "owner_category": "individual", "email": "[email protected]", "mobile_phone": "+33612345678"}'

# 3. Create a building, then an apartment inside it
PLACE=$(curl -s -X POST https://api.faireplace.com/api/places \
  -H "Authorization: Bearer $FP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Residence Les Jardins", "owner_id": "<owner_id>", "postal_code": "75012", "city": "Paris"}' | jq -r '.id')

curl -X POST https://api.faireplace.com/api/places/$PLACE/estates \
  -H "Authorization: Bearer $FP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area": 45.0, "number_of_room": 2, "floor": 3}'

# 4. Create the lease
curl -X POST https://api.faireplace.com/api/leases \
  -H "Authorization: Bearer $FP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"estate_id": "<estate_id>", "rent_amount": 950.00, "deposit_amount": 950.00, "start_date": "2026-04-01", "end_date": "2029-03-31"}'

# 5. Generate the PDF
curl -X POST https://api.faireplace.com/api/leases/<lease_id>/pdf \
  -H "Authorization: Bearer $FP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template_type": "StandardLease"}'

# 6. Collect the signatures (OTP by SMS)
curl -X POST https://api.faireplace.com/api/leases/<lease_id>/signature/initiate \
  -H "Authorization: Bearer $FP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf_id": "<pdf_id>", "signers": [{"signer_type": "PROPRIETAIRE", "first_name": "Jean", "last_name": "Dupont", "email": "[email protected]", "phone": "+33612345678"}]}'

Full tutorial, with responses Try it in the sandbox

Everything else

QuickstartYour first call PropertiesBuildings, rooms, meters AuthenticationAPI keys, permissions LeasesContracts, charges, receipts SandboxTest off production SignatureseIDAS, OTP, proof file ErrorsCodes, retries, rate limits ComplianceRent caps, IRL, tense zones Core conceptsPagination, tenancy, media Tenants and ownersThe people on a lease PaymentsCredits and webhooks API reference574 operations

Something unclear or missing? Write to [email protected]Hosted in France, on Scaleway.

Last modified on August 13, 2026

What the API actually does for you

French rental law is the hard part. It is also the part you do not have to write.

Leases that hold up

Generate a lease PDF that follows the loi ALUR, then collect advanced electronic signatures with OTP verification. No third-party signature service to plug in.

See the workflow

Compliance, checked on write

Rent caps, IRL revision, deposit ceilings, tense-zone rules. Validated when the lease is created, not left to your code to rediscover.

How compliance works

The whole lifecycle

Buildings, apartments, rooms, meters, charges, receipts, amendments, termination. 574 operations, one consistent REST surface.

Explore the API

From zero to signed lease in six calls

Every call below is copy-paste ready. Replace the placeholders and run it.

Code

# 1. Set your API key export FP_API_KEY="fp_your_api_key_here" # 2. Create an owner curl -X POST https://api.faireplace.com/api/owners \ -H "Authorization: Bearer $FP_API_KEY" \ -H "Content-Type: application/json" \ -d '{"first_name": "Jean", "last_name": "Dupont", "owner_category": "individual", "email": "[email protected]", "mobile_phone": "+33612345678"}' # 3. Create a building, then an apartment inside it PLACE=$(curl -s -X POST https://api.faireplace.com/api/places \ -H "Authorization: Bearer $FP_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "Residence Les Jardins", "owner_id": "<owner_id>", "postal_code": "75012", "city": "Paris"}' | jq -r '.id') curl -X POST https://api.faireplace.com/api/places/$PLACE/estates \ -H "Authorization: Bearer $FP_API_KEY" \ -H "Content-Type: application/json" \ -d '{"area": 45.0, "number_of_room": 2, "floor": 3}' # 4. Create the lease curl -X POST https://api.faireplace.com/api/leases \ -H "Authorization: Bearer $FP_API_KEY" \ -H "Content-Type: application/json" \ -d '{"estate_id": "<estate_id>", "rent_amount": 950.00, "deposit_amount": 950.00, "start_date": "2026-04-01", "end_date": "2029-03-31"}' # 5. Generate the PDF curl -X POST https://api.faireplace.com/api/leases/<lease_id>/pdf \ -H "Authorization: Bearer $FP_API_KEY" \ -H "Content-Type: application/json" \ -d '{"template_type": "StandardLease"}' # 6. Collect the signatures (OTP by SMS) curl -X POST https://api.faireplace.com/api/leases/<lease_id>/signature/initiate \ -H "Authorization: Bearer $FP_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pdf_id": "<pdf_id>", "signers": [{"signer_type": "PROPRIETAIRE", "first_name": "Jean", "last_name": "Dupont", "email": "[email protected]", "phone": "+33612345678"}]}'