French communes reference: postal code to INSEE code, population, departement, region

Official French administrative reference from geo.api.gouv.fr (INSEE/IGN data). Look up communes by ?cp=31700 (postal code), ?code=31056 (INSEE), ?nom=Blagnac (fuzzy name) or ?lat=43.63&lon=1.37 (commune containing a point). Returns up to 20 communes with name, INSEE code, population, postal codes, departement, region and EPCI. The postal-to-INSEE mapping is the pivot key for joining French territorial datasets. Cached 7 days.

get/v1/fr/communes

Request

  • Base URL: https://data.greeneris.io (the document declares no server; this is the origin it was published from)
  • URL: https://data.greeneris.io/v1/fr/communes
  • Auth: none declared

Query parameters

cpstring

5-digit postal code, e.g. 31700

codestring

5-character INSEE commune code, e.g. 31056

nomstring

Commune name, fuzzy search

latnumber

Latitude (with lon: commune containing the point)

lonnumber

Longitude (with lat)

Response

Successful response

unknown required

Changes

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