Housing and Main Residences by Characteristics - Detailed Data (LOG1, PRINC2, PRINC3, PRINC5 and PRINC27)Logements et résidences principales selon leurs caractéristiques - Données détaillées (LOG1, PRINC2, PRINC3, PRINC5 et PRINC27)

Logements et résidences principales selon leurs caractéristiques - Données détaillées (LOG1, PRINC2, PRINC3, PRINC5 et PRINC27)Housing and Main Residences by Characteristics - Detailed Data (LOG1, PRINC2, PRINC3, PRINC5 and PRINC27)

APIExecutable4/7blocked by joinableQuery nowOpen workbench Subscribe🇫🇷France

Website Docs

This API from INSEE, the French national statistics institute, provides detailed data on housing units and main residences broken down by their characteristics, at the municipal and supra-municipal level, covering all of France excluding Mayotte. It corresponds to census tables LOG1, PRINC2, PRINC3, PRINC5 and PRINC27, allowing analysis of housing stock composition and residential characteristics across French territorial units.Caractéristiques des logements et les résidences principales selon leurs caractéristiques, au niveau communal et supracommunal pour la France hors Mayotte.

Filter by dimension Run verified request Read the docs

Trust score

How is this computed?

good

Weighted across five axes. Tap a ring for what it measures.

Data schema (13 fields)

Click a field to see example values.

Field	Type	Description
GEOTerritory	string	Geographic code for the commune or aggregated area (e.g. urban area zoning).Geographic code for the commune or aggregated area (e.g. urban area zoning).
NOR	string	Classification code, meaning not further specified in source data.Classification code, meaning not further specified in source data.
BUILD_ENDBuild end	string	Category for period of completion of dwelling construction.Category for period of completion of dwelling construction.
NOC	string	Category for number of occupants in the dwelling ('_T' for total).Category for number of occupants in the dwelling ('_T' for total).
TDW	string	Code identifying the type of dwelling.Code identifying the type of dwelling.
TSH	string	Category related to household composition or size ('_T' for total).Category related to household composition or size ('_T' for total).
LIFT	string	Category indicating presence of a lift in the building ('_T' for total).Category indicating presence of a lift in the building ('_T' for total).
FREQFrequency	string	Frequency of the observation, e.g. annual.Frequency of the observation, e.g. annual.
TIME_PERIODPeriod	string	Reference year of the observation.Reference year of the observation.
RP_MEASURERp measure	string	Type of measure reported, e.g. number of dwellings.Type of measure reported, e.g. number of dwellings.
OCS	string	Occupancy status of the dwelling, e.g. main residence.Occupancy status of the dwelling, e.g. main residence.
L_STAYL stay	string	Duration bracket, in years, of residence in the dwelling.Duration bracket, in years, of residence in the dwelling.
OBS_VALUE_NIVEAUValue	number	Estimated level value for the indicator, e.g. number of dwellings.Estimated level value for the indicator, e.g. number of dwellings.

Schema captured from melodi 15 hours ago.

Query the data

Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.

Where=

Sort by

Sample data (5 records)

Record 1GEO: 2026-AAV2020-001 · NOC: _T

{
  "GEO": "2026-AAV2020-001",
  "NOC": "_T",
  "NOR": "R1",
  "OCS": "DW_MAIN",
  "TDW": "1",
  "TSH": "_T",
  "FREQ": "A",
  "LIFT": "_T",
  "L_STAY": "Y10T19",
  "BUILD_END": "_T",
  "RP_MEASURE": "DWELLINGS",
  "TIME_PERIOD": "2023",
  "OBS_VALUE_NIVEAU": 1267.91542
}

Record 2GEO: 2026-AAV2020-001 · NOC: _T

{
  "GEO": "2026-AAV2020-001",
  "NOC": "_T",
  "NOR": "R1",
  "OCS": "DW_MAIN",
  "TDW": "2",
  "TSH": "_T",
  "FREQ": "A",
  "LIFT": "_T",
  "L_STAY": "Y10T19",
  "BUILD_END": "_T",
  "RP_MEASURE": "DWELLINGS",
  "TIME_PERIOD": "2023",
  "OBS_VALUE_NIVEAU": 73048.35505
}

Record 3GEO: 2026-AAV2020-001 · NOC: _T

{
  "GEO": "2026-AAV2020-001",
  "NOC": "_T",
  "NOR": "R1",
  "OCS": "DW_MAIN",
  "TDW": "3T6",
  "TSH": "_T",
  "FREQ": "A",
  "LIFT": "_T",
  "L_STAY": "Y10T19",
  "BUILD_END": "_T",
  "RP_MEASURE": "DWELLINGS",
  "TIME_PERIOD": "2023",
  "OBS_VALUE_NIVEAU": 7866.36052
}

Record 4GEO: 2026-AAV2020-001 · NOC: _T

{
  "GEO": "2026-AAV2020-001",
  "NOC": "_T",
  "NOR": "R1",
  "OCS": "DW_MAIN",
  "TDW": "_T",
  "TSH": "_T",
  "FREQ": "A",
  "LIFT": "_T",
  "L_STAY": "Y10T19",
  "BUILD_END": "_T",
  "RP_MEASURE": "DWELLINGS",
  "TIME_PERIOD": "2023",
  "OBS_VALUE_NIVEAU": 82182.63099
}

Record 5GEO: 2026-AAV2020-001 · NOC: _T

{
  "GEO": "2026-AAV2020-001",
  "NOC": "_T",
  "NOR": "R2",
  "OCS": "DW_MAIN",
  "TDW": "1",
  "TSH": "_T",
  "FREQ": "A",
  "LIFT": "_T",
  "L_STAY": "Y10T19",
  "BUILD_END": "_T",
  "RP_MEASURE": "DWELLINGS",
  "TIME_PERIOD": "2023",
  "OBS_VALUE_NIVEAU": 7770.4193
}

Live sample captured at profiling time — values may have changed upstream.

Verification Status

Using the API

Configuration

Base URL: https://api.insee.fr/melodi/data/DS_RP_TD_LOGEMENT_CARACT_PRINC

Query examples

curl -s 'https://api.insee.fr/melodi/data/DS_RP_TD_LOGEMENT_CARACT_PRINC?maxResult=20' -H 'Accept: application/json'

First 20 observations (dimensions + measures) as JSON.

Full API documentation ↗

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.