---
title: "Geocode or reverse-geocode any French address (official BAN, with confidence score)"
method: GET
path: "/v1/fr/geocode"
---

# Geocode or reverse-geocode any French address (official BAN, with confidence score)

`GET /v1/fr/geocode`

## 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/geocode`
- Auth: none declared

French address geocoding on the official Base Adresse Nationale (api-adresse.data.gouv.fr, Etalab/IGN, continuously updated). Forward: ?q=8 boulevard du port amiens with optional &type=housenumber|street|locality|municipality &citycode=80021 (INSEE filter). Reverse: ?lat=49.897&lon=2.290. &limit=1-10 (default 3). Each match returns normalized label, confidence score, lat/lon, street, postcode, city, INSEE citycode and context. No match returns 400 (not billed). Cached 24h.

## Query parameters

- `q` string
- `lat` number
- `lon` number
- `type` 'housenumber' | 'street' | 'locality' | 'municipality'
- `citycode` string
- `limit` integer

## Response `200`

Successful response

- unknown

---

[API](https://skmtc.dev/greeneris/apis/eu-verify.md) · [All operations](https://skmtc.dev/greeneris/apis/eu-verify/llms.txt) · [OpenAPI document](https://skmtc.dev/greeneris/apis/eu-verify/revisions/766cf4a67d8f?raw)