Api Endpoint

France Communes Lookup

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.

Open interactive test console

Offering

Provider: data.greeneris.io
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Location And Travel
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://data.greeneris.io/v1/fr/communes
MIME type: application/json
First seen: 2026-10-16T01:51:20.002Z
Last seen: 2026-11-04T03:34:56.116Z
Tags: france, communes, insee, Geo, reference, admin

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.001 USDC
Atomic price: 1000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "payTo": "0x6ab8efe305cce67daa48c97bde29c04402822dff"
  }
]

Observed health

Status: Healthy
Latest latency: 100 ms
Average latency: 479 ms
HTTP status: 402
Last checked: 2026-11-04T03:34:56.110Z
Reachability: 100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "cp": {
          "type": "string",
          "description": "5-digit postal code, e.g. 31700"
        },
        "code": {
          "type": "string",
          "description": "5-character INSEE commune code, e.g. 31056"
        },
        "nom": {
          "type": "string",
          "description": "Commune name, fuzzy search"
        },
        "lat": {
          "type": "number",
          "description": "Latitude (with lon: commune containing the point)"
        },
        "lon": {
          "type": "number",
          "description": "Longitude (with lat)"
        }
      }
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "json",
  "example": {
    "count": 2,
    "source": "geo.api.gouv.fr decoupage administratif (Etalab, INSEE/IGN data, Licence Ouverte 2.0)",
    "communes": [
      {
        "epci": {
          "nom": "Toulouse Métropole",
          "code": "243100518"
        },
        "name": "Beauzelle",
        "region": {
          "nom": "Occitanie",
          "code": "76"
        },
        "insee_code": "31056",
        "population": 8713,
        "departement": {
          "nom": "Haute-Garonne",
          "code": "31"
        },
        "postal_codes": [
          "31700"
        ]
      },
      {
        "epci": {
          "nom": "Toulouse Métropole",
          "code": "243100518"
        },
        "name": "Blagnac",
        "region": {
          "nom": "Occitanie",
          "code": "76"
        },
        "insee_code": "31069",
        "population": 27604,
        "departement": {
          "nom": "Haute-Garonne",
          "code": "31"
        },
        "postal_codes": [
          "31700"
        ]
      }
    ]
  }
}