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/7Query 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

Data schema (13 fields)

Click a field to see example values.

Field	Type	Description
GEOTerritory	string	—
NOR	string	—
BUILD_ENDBuild end	string	—
NOC	string	—
TDW	string	—
TSH	string	—
LIFT	string	—
FREQFrequency	string	—
TIME_PERIODPeriod	string	—
RP_MEASURERp measure	string	—
OCS	string	—
L_STAYL stay	string	—
OBS_VALUE_NIVEAUValue	number	—

Schema captured from melodi 4 days 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.