FairePlace Property Management API

Rent Regulation & Rent Control

Endpointhttps://api.faireplace.com/api

Country references, rent regulation checks, and rent control compliance

List countries

GET

https://api.faireplace.com/api

/legislative-zones

List all available countries (jurisdictions). Each country has an ISO 3166-1 alpha-2 code and determines which rent regulations apply.

List countries › Responses

object[]

id

string · uuid

code

string

ISO 3166-1 alpha-2 country code

Example: FR

name

string

Country name

Example: France

is_active

boolean

created_at

string · date-time

updated_at

string · date-time

GET/legislative-zones

curl --request GET \
  --url https://api.faireplace.com/api/legislative-zones

shell

Example Responses

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "code": "FR",
    "name": "France",
    "is_active": true,
    "created_at": "2024-08-25T15:00:00Z",
    "updated_at": "2024-08-25T15:00:00Z"
  }
]

json

application/json

Check rent regulation by postal code

POST

https://api.faireplace.com/api

/legislative-zones/rent-regulation/check

Check whether a postal code falls within a regulated rent area (zone tendue). Returns regulation type, applicable rules, geographical zone, and IRL index information.

Check rent regulation by postal code › Request Body

postal_code

string · required

Check rent regulation by postal code › Responses

postal_code

string

city_name

string

is_rent_regulated

boolean

insee_code

string

object

object[]

object

POST/legislative-zones/rent-regulation/check

curl --request POST \
  --url https://api.faireplace.com/api/legislative-zones/rent-regulation/check \
  --header 'Content-Type: application/json' \
  --data '
{
  "postal_code": "postal_code"
}
'

shell

Example Request Body

{
  "postal_code": "postal_code"
}

json

Example Responses

{
  "postal_code": "postal_code",
  "city_name": "city_name",
  "is_rent_regulated": true,
  "insee_code": "insee_code",
  "regulation_type": {
    "type_name": "type_name",
    "description": "description",
    "rules": [
      "string"
    ]
  },
  "regulations": [
    {
      "name": "name",
      "description": "description",
      "is_applicable": true
    }
  ],
  "geographical_zone": {
    "zone_type": "zone_type",
    "irl_cap_percentage": 0,
    "description": "description",
    "postal_code_pattern": "postal_code_pattern"
  },
  "irl_info": {
    "current_quarter": "current_quarter",
    "current_value": 0,
    "previous_year_value": 0,
    "publication_date": {},
    "data_source": "data_source",
    "last_update": "last_update",
    "annual_increase_cap": 0
  }
}

json

application/json

Get rent regulation data by INSEE code

GET

https://api.faireplace.com/api

/legislative-zones/rent-regulation/zone/{insee_code}

Retrieve rent regulation details for a specific commune identified by its INSEE code.

Get rent regulation data by INSEE code › path Parameters

insee_code

string · required

Get rent regulation data by INSEE code › Responses

200

postal_code

string

city_name

string

is_rent_regulated

boolean

insee_code

string

object

object[]

object

GET/legislative-zones/rent-regulation/zone/{insee_code}

curl --request GET \
  --url https://api.faireplace.com/api/legislative-zones/rent-regulation/zone/:insee_code

shell

Example Responses

{
  "postal_code": "postal_code",
  "city_name": "city_name",
  "is_rent_regulated": true,
  "insee_code": "insee_code",
  "regulation_type": {
    "type_name": "type_name",
    "description": "description",
    "rules": [
      "string"
    ]
  },
  "regulations": [
    {
      "name": "name",
      "description": "description",
      "is_applicable": true
    }
  ],
  "geographical_zone": {
    "zone_type": "zone_type",
    "irl_cap_percentage": 0,
    "description": "description",
    "postal_code_pattern": "postal_code_pattern"
  },
  "irl_info": {
    "current_quarter": "current_quarter",
    "current_value": 0,
    "previous_year_value": 0,
    "publication_date": {},
    "data_source": "data_source",
    "last_update": "last_update",
    "annual_increase_cap": 0
  }
}

json

application/json

Check rent control compliance

POST

https://api.faireplace.com/api

/legislative-zones/rent-control/check

Verify whether a proposed rent complies with local rent control rules (encadrement des loyers). Compares the proposed rent against reference rents for the address, room count, construction period, and furnishing status.

Check rent control compliance › Request Body

address

string · required

postal_code

string · required

room_count

integer · required

surface_area

number · float · required

construction_period

string · enum · required

Enum values:

before_1946

19461970

19711990

19912005

after_2005

after_1990

is_furnished

boolean · required

proposed_rent

number · float · required

Check rent control compliance › Responses

territory

string

address

string

administrative_quarter

string

quarter_id

integer | null

object

proposed_rent_per_sqm

number · float

is_compliant

boolean

compliance_status

string

object[]

data_source

string

last_update

string

POST/legislative-zones/rent-control/check

curl --request POST \
  --url https://api.faireplace.com/api/legislative-zones/rent-control/check \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "address",
  "postal_code": "postal_code",
  "room_count": 0,
  "surface_area": 0,
  "construction_period": "before_1946",
  "is_furnished": true,
  "proposed_rent": 0
}
'

shell

Example Request Body

{
  "address": "address",
  "postal_code": "postal_code",
  "room_count": 0,
  "surface_area": 0,
  "construction_period": "before_1946",
  "is_furnished": true,
  "proposed_rent": 0
}

json

Example Responses

{
  "territory": "territory",
  "address": "address",
  "administrative_quarter": "administrative_quarter",
  "quarter_id": {},
  "coordinates": {
    "longitude": 0,
    "latitude": 0
  },
  "reference_rent_data": {
    "reference_rent": 0,
    "reference_rent_increased": 0,
    "reference_rent_decreased": 0,
    "year": "year"
  },
  "proposed_rent_per_sqm": 0,
  "is_compliant": true,
  "compliance_status": "compliance_status",
  "applicable_regulations": [
    {
      "name": "name",
      "description": "description",
      "reference_url": {}
    }
  ],
  "data_source": "data_source",
  "last_update": "last_update"
}

json

application/json

Get administrative quarter from address

GET

https://api.faireplace.com/api

/legislative-zones/rent-control/quarter

Resolve an address and postal code to an administrative quarter used for rent control reference data.

Get administrative quarter from address › query Parameters

address

string · required

postal_code

string · required

Get administrative quarter from address › Responses

200

id

integer

name

string

object

GET/legislative-zones/rent-control/quarter

curl --request GET \
  --url 'https://api.faireplace.com/api/legislative-zones/rent-control/quarter?address=%3Cstring%3E&postal_code=%3Cstring%3E'

shell

Example Responses

{
  "id": 0,
  "name": "name",
  "coordinates": {
    "longitude": 0,
    "latitude": 0
  }
}

json

application/json

Get reference rent for a quarter and parameters

GET

https://api.faireplace.com/api

/legislative-zones/rent-control/reference-rent

Retrieve reference rent values (loyer de référence, majoré, minoré) for a specific quarter, room count, construction period, furnishing status, and year.

Get reference rent for a quarter and parameters › query Parameters

quarter

string · required

room_count

integer · required

construction_period

string · enum · required

Enum values:

before_1946

19461970

19711990

19912005

after_2005

after_1990

is_furnished

boolean · required

year

string · required

Get reference rent for a quarter and parameters › Responses

200

reference_rent

number · float

reference_rent_increased

number · float

reference_rent_decreased

number · float

year

string

GET/legislative-zones/rent-control/reference-rent

curl --request GET \
  --url 'https://api.faireplace.com/api/legislative-zones/rent-control/reference-rent?quarter=%3Cstring%3E&room_count=%3Cnumber%3E&construction_period=%3Cstring%3E&is_furnished=%3Cbool%3E&year=%3Cstring%3E'

shell

Example Responses

{
  "reference_rent": 0,
  "reference_rent_increased": 0,
  "reference_rent_decreased": 0,
  "year": "year"
}

json

application/json

List supported territories for rent control

GET

https://api.faireplace.com/api

/legislative-zones/rent-control/territories

List all territories (cities/communes) that have rent control data available.

List supported territories for rent control › Responses

200

territories

string[]

GET/legislative-zones/rent-control/territories

curl --request GET \
  --url https://api.faireplace.com/api/legislative-zones/rent-control/territories

shell

Example Responses

{
  "territories": [
    "string"
  ]
}

json

application/json

Media Lease Types