FairePlace API
Build property management into your product.
The FairePlace API lets you manage rental properties, create legally compliant leases, collect electronic signatures, and handle payments — all through a standard REST interface.
What you can do
| Capability | Description |
|---|---|
| Property management | Create and organize buildings, apartments, rooms, and equipment |
| Lease creation | Generate leases compliant with French rental law (Loi Alur, Loi Elan) |
| Electronic signatures | Collect legally binding signatures with eIDAS compliance and OTP verification |
| Rent control | Automatic rent cap validation using IRL index and legislative zones |
| PDF generation | Generate formatted lease documents ready for signature |
| Tenant management | Track tenants, guarantors, and contacts with financial verification |
| Payments | Purchase signature credits via Stripe integration |
How it works
Code
Your application authenticates with a JWT token scoped to your organization. All data is isolated per tenant — you only see and manage your own properties, leases, and tenants.
Quick links
- Getting Started — Make your first API call in 5 minutes
- Authentication — JWT tokens, permissions, and multi-tenant access
- Create a Lease End-to-End — Full tutorial from property to signed lease
- Electronic Signatures — eIDAS-compliant signature workflow
- API Reference — Interactive documentation for all endpoints
Key concepts
Multi-tenant isolation
Every API request is scoped to your organization via the JWT token. Data is completely isolated between tenants. You cannot access another organization's data. See Multi-tenancy for details.
French regulatory compliance
FairePlace handles the complexity of French rental law:
- Rent control (encadrement des loyers) — automatic validation against reference rents per legislative zone
- IRL revision (Indice de Reference des Loyers) — built-in rent revision index tracking
- Loi Alur compliance — required lease clauses and tenant protections
- Legislative zones (zones tendues) — location-based regulatory requirements
See Rent Regulation for details.
Electronic signatures
Integrated eIDAS-compliant electronic signature workflow:
- OTP verification via SMS for each signer
- PAdES-B signed PDF with Certinomis certificate authority
- Tamper-proof proof archive in JSON format
- Supports owners, tenants, and real estate agents as signers
REST conventions
- JSON request and response bodies
- UUID identifiers for all resources
- ISO 8601 date formats
- Bearer token authentication
- Standard HTTP status codes (200, 201, 400, 401, 403, 404, 422)
- Pagination, filtering, and sorting on list endpoints
See Pagination for list endpoint patterns.
Base URL
Code
Need help?
- Browse the Property Management guides for detailed walkthroughs
- Check Error Handling when something goes wrong
- Contact our team at [email protected]