Characteristics of the electoral bodyCaractéristiques du corps électoral

Caractéristiques du corps électoralCharacteristics of the electoral body

APIJoinable5/7Query nowOpen workbench Subscribe🇫🇷France

This API provides data from INSEE, the French national statistics institute, on registered voters (the electoral body), broken down by department, region, and for France as a whole, including overseas territories except New Caledonia, depending on the indicator considered. It is intended for users seeking demographic and geographic statistics on the composition of the electorate at various administrative levels within France.Données sur les électeurs au niveau départemental, régional et France entière y compris les collectivités d'outre mer hors Nouvelle-Calédonie en fonction de l'indicateur.

Filter by dimension Run verified request Read the docs

Data schema (12 fields)

Click a field to see example values.

Field	Type	Description
GEOTerritory	string	Geographic area code, such as commune, arrondissement or department.Geographic area code, such as commune, arrondissement or department.
NATIONALITY	string	Nationality code of the electors concerned.Nationality code of the electors concerned.
REU_LIST_TYPEReu list type	string	Type of electoral list to which the data refers.Type of electoral list to which the data refers.
REU_REASON_REGReu reason reg	string	Reason code for registration on the electoral list.Reason code for registration on the electoral list.
SEX	string	Sex of the electors, or total if not broken down.Sex of the electors, or total if not broken down.
REU_REASON_RMVReu reason rmv	string	Reason code for removal from the electoral list.Reason code for removal from the electoral list.
FREQFrequency	string	Frequency of the data, e.g. daily.Frequency of the data, e.g. daily.
TIME_PERIODPeriod	string	Date or period to which the observation refers.Date or period to which the observation refers.
REU_ELECTION_TYPEReu election type	string	Type of election concerned, e.g. municipal.Type of election concerned, e.g. municipal.
REU_MEASUREReu measure	string	Indicator measured, such as number of registered voters.Indicator measured, such as number of registered voters.
AGE	string	Age group of the electors, or total if not broken down.Age group of the electors, or total if not broken down.
OBS_VALUE_NIVEAUValue	number	Observed value of the indicator for the given area and criteria.Observed value of the indicator for the given area and criteria.

Schema captured from melodi 7 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 1AGE: _T · GEO: 2025-ARM-75113

{
  "AGE": "_T",
  "GEO": "2025-ARM-75113",
  "SEX": "_T",
  "FREQ": "D",
  "NATIONALITY": "250",
  "REU_MEASURE": "VOTERS",
  "TIME_PERIOD": "2026-02-11",
  "REU_LIST_TYPE": "LP",
  "REU_REASON_REG": "_Z",
  "REU_REASON_RMV": "_Z",
  "OBS_VALUE_NIVEAU": 114927,
  "REU_ELECTION_TYPE": "MUN"
}

Record 2AGE: _T · GEO: 2025-COM-01198

{
  "AGE": "_T",
  "GEO": "2025-COM-01198",
  "SEX": "_T",
  "FREQ": "D",
  "NATIONALITY": "250",
  "REU_MEASURE": "VOTERS",
  "TIME_PERIOD": "2026-02-11",
  "REU_LIST_TYPE": "LP",
  "REU_REASON_REG": "_Z",
  "REU_REASON_RMV": "_Z",
  "OBS_VALUE_NIVEAU": 218,
  "REU_ELECTION_TYPE": "MUN"
}

Record 3AGE: _T · GEO: 2025-ARM-13216

{
  "AGE": "_T",
  "GEO": "2025-ARM-13216",
  "SEX": "_T",
  "FREQ": "D",
  "NATIONALITY": "150",
  "REU_MEASURE": "VOTERS",
  "TIME_PERIOD": "2026-02-11",
  "REU_LIST_TYPE": "LC",
  "REU_REASON_REG": "_Z",
  "REU_REASON_RMV": "_Z",
  "OBS_VALUE_NIVEAU": 41,
  "REU_ELECTION_TYPE": "MUN"
}

Record 4AGE: _T · GEO: 2025-ARM-69387

{
  "AGE": "_T",
  "GEO": "2025-ARM-69387",
  "SEX": "_T",
  "FREQ": "D",
  "NATIONALITY": "150",
  "REU_MEASURE": "VOTERS",
  "TIME_PERIOD": "2026-02-11",
  "REU_LIST_TYPE": "LC",
  "REU_REASON_REG": "_Z",
  "REU_REASON_RMV": "_Z",
  "OBS_VALUE_NIVEAU": 483,
  "REU_ELECTION_TYPE": "MUN"
}

Record 5AGE: _T · GEO: 2025-COM-01248

{
  "AGE": "_T",
  "GEO": "2025-COM-01248",
  "SEX": "_T",
  "FREQ": "D",
  "NATIONALITY": "250",
  "REU_MEASURE": "VOTERS",
  "TIME_PERIOD": "2026-02-11",
  "REU_LIST_TYPE": "LP",
  "REU_REASON_REG": "_Z",
  "REU_REASON_RMV": "_Z",
  "OBS_VALUE_NIVEAU": 1814,
  "REU_ELECTION_TYPE": "MUN"
}

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_ELECTORAL

Query examples

curl -s 'https://api.insee.fr/melodi/data/DS_ELECTORAL?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.