Public Tools

Deposit an anonymous lease draft

Stores an opaque lease-draft payload (FP2-T1 contract) and returns a short-lived draft_token (TTL 30 minutes). The landing carries the token in a .faireplace.com cookie and exchanges it at authenticated ingestion.

The body must be a JSON object containing at least owner, logement and lease. Public, unauthenticated tool.

Example

curl -X POST https://api.faireplace.com/api/public/tools/bail-draft \
  -H "Content-Type: application/json" \
  -d '{
    "owner": { "last_name": "Dupont" },
    "logement": { "name": "T2" },
    "lease": { "rent_amount": 850.0 }
  }'

Response (201):

{
  "draft_token": "f47ac10b58cc4372a5670e02b2c3d479",
  "expires_at": "2026-06-20T10:30:00+00:00"
}
post/public/tools/bail-draft

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/public/tools/bail-draft
  • Auth: none required

Request body

ownerobject required

Landlord block (free-form draft).

logementobject required

Dwelling block (free-form draft).

leaseobject required

Lease block (free-form draft).

lesseeobject nullable
schema_versioninteger

Response

Draft stored; opaque token returned.

draft_tokenstring required

Opaque token to carry in a .faireplace.com cookie, then exchanged at authenticated ingestion. Valid for 30 minutes.

expires_atstring date-time required

Expiry timestamp (ISO 8601, now + TTL).

Example response

{
  "draft_token": "f47ac10b58cc4372a5670e02b2c3d479",
  "expires_at": "2026-06-20T10:30:00+00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.