{"uid":"cap_GEpYq6gv2-j-7ObTXcOcf","slug":"greeneris-french-communes-lookup-adf3b922","name":"Greeneris French Communes Lookup","description":"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.","url":"https://data.greeneris.io/v1/fr/communes","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"cp":{"type":"string","description":"5-digit postal code, e.g. 31700"},"lat":{"type":"number","description":"Latitude (with lon: commune containing the point)"},"lon":{"type":"number","description":"Longitude (with lat)"},"nom":{"type":"string","description":"Commune name, fuzzy search"},"code":{"type":"string","description":"5-character INSEE commune code, e.g. 31056"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"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"]}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZvojUH-M9BJMMdatRGBrN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up French communes (municipalities) by postal code, coordinates, name, or INSEE code, returning administrative and demographic data.","exampleAgentPrompt":"What communes are in postal code 31700 in France? I need the INSEE codes, population, département, and region for each one.","exampleUseCases":[{"title":"Validate customer addresses for French tax filing","prompt":"I'm processing a batch of French customer registrations and need to verify each postal code maps to a real commune. Can you look up the INSEE code and département for postal code 75001, and tell me if it's valid?"},{"title":"Geocode field service appointments to regions","prompt":"Our technician is being dispatched to coordinates 48.8566, 2.3522 in France. What commune is that, and which région and EPCI should I assign this job to for regional billing?"},{"title":"Enrich property listings with administrative metadata","prompt":"I have a property at postal code 13013 in France that I'm listing. Get me the official commune name, INSEE code, population, and what département and région it's in so I can populate the listing details correctly."}],"resultDescription":"A JSON object with a count of matching communes and a list of commune records, each containing: commune name, INSEE code, list of postal codes, population, département (name and code), region (name and code), and EPCI intercommunality (name and code). The source attribution to geo.api.gouv.fr / Etalab is included.","failureModes":["No matching commune found for the given parameters — returns empty communes array","Invalid or malformed postal code / INSEE code — may return no results","Coordinates outside France — no commune returned","HTTP 402 returned if payment has not been made via x402 protocol before the call","Ambiguous name query returns multiple results — caller must filter"],"whenToPreferThis":"Use this endpoint when you need authoritative French administrative geography data — mapping postal codes to communes, resolving coordinates to a municipality, or enriching addresses with INSEE codes, population, and administrative hierarchy (département, region, EPCI). Prefer this over generic geocoding when you specifically need INSEE codes or official French administrative identifiers required for business registration, tax filings, or French regulatory workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:00:27.168Z","isFirstParty":false}