Api Endpoint

eu-verify

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.

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/geocode
MIME type
application/json
First seen
2026-10-16T01:50:14.534Z
Last seen
Tags
france, geocoding, address, Geo, ban, insee

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
101 ms
Average latency
531 ms
HTTP status
402
Last checked
Reachability
100% over 13 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": {
        "q": {
          "type": "string",
          "description": "Free-text French address (forward mode)"
        },
        "lat": {
          "type": "number",
          "description": "Latitude (reverse mode, with lon)"
        },
        "lon": {
          "type": "number",
          "description": "Longitude (reverse mode, with lat)"
        },
        "type": {
          "type": "string",
          "enum": [
            "housenumber",
            "street",
            "locality",
            "municipality"
          ],
          "description": "Restrict match type"
        },
        "citycode": {
          "type": "string",
          "description": "Filter by 5-char INSEE city code"
        },
        "limit": {
          "type": "integer",
          "description": "Max matches, 1-10 (default 3)"
        }
      }
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "citycode": {
              "description": "Filter by 5-char INSEE city code",
              "type": "string"
            },
            "lat": {
              "description": "Latitude (reverse mode, with lon)",
              "type": "number"
            },
            "limit": {
              "description": "Max matches, 1-10 (default 3)",
              "type": "integer"
            },
            "lon": {
              "description": "Longitude (reverse mode, with lat)",
              "type": "number"
            },
            "q": {
              "description": "Free-text French address (forward mode)",
              "type": "string"
            },
            "type": {
              "description": "Restrict match type",
              "enum": [
                "housenumber",
                "street",
                "locality",
                "municipality"
              ],
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}