Api Endpoint

Japan Address Geocode

Japanese forward geocoding from an address to coordinates. Keywords: Japan geocoder, address to coordinates, building-level geocode, Jageocoder, chome, block, lot, house. Returns provider-neutral local candidates, coordinates, address IDs, hierarchy levels, unmatched tails, and partial-match warnings. Jageocoder level 5/6 is oaza/aza, level 7 is block, and level 8 is a building or house node when present in the dictionary; town-level evidence is not a door-number or coordinate accuracy claim.

Open interactive test console

Offering

Provider
api.jpverify.com
Method
POST
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://api.jpverify.com/jp-address/geocode
MIME type
Not provided
First seen
2026-10-16T01:50:14.534Z
Last seen
Tags
japan, address, geocode, forward-geocoding, coordinates

Payment pricing

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

Payment option 1
0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "payTo": "0xe4A4E5B226bE71e7b6eD523bc7a91089c770572F"
  }
]

Observed health

Status
Reachable
Latest latency
1257 ms
Average latency
1282 ms
HTTP status
405
Last checked
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

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "description": "Forward-geocoded Japanese address. / ジオコードする日本住所。",
          "maxLength": 500,
          "type": [
            "string",
            "null"
          ]
        },
        "components": {
          "description": "Parsed address components when address is already parsed; at least one non-empty address field is required. / 解析済み住所構成要素。空でない住所項目を1つ以上指定します。",
          "type": [
            "object",
            "null"
          ]
        },
        "max_candidates": {
          "default": 3,
          "description": "Maximum candidates. / 候補数上限。",
          "maximum": 10,
          "minimum": 1,
          "type": "integer"
        },
        "minimum_acceptable_level": {
          "description": "Minimum hierarchy level accepted as matched; lower results are partial. / matchedとして受け入れる最小階層。下位候補はpartial。",
          "maximum": 8,
          "minimum": 1,
          "type": [
            "integer",
            "null"
          ]
        },
        "postal_code": {
          "description": "Optional postal-code evidence. / 任意の郵便番号根拠。",
          "pattern": "^\\d{3}-?\\d{4}$",
          "type": [
            "string",
            "null"
          ]
        },
        "provider": {
          "default": "auto",
          "description": "Geocoder provider selection. / 地理コードプロバイダ。",
          "enum": [
            "auto",
            "local_jageocoder"
          ],
          "type": "string"
        }
      },
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "address": {
              "description": "Forward-geocoded Japanese address. / ジオコードする日本住所。",
              "maxLength": 500,
              "type": [
                "string",
                "null"
              ]
            },
            "components": {
              "description": "Parsed address components when address is already parsed; at least one non-empty address field is required. / 解析済み住所構成要素。空でない住所項目を1つ以上指定します。",
              "type": [
                "object",
                "null"
              ]
            },
            "max_candidates": {
              "default": 3,
              "description": "Maximum candidates. / 候補数上限。",
              "maximum": 10,
              "minimum": 1,
              "type": "integer"
            },
            "minimum_acceptable_level": {
              "description": "Minimum hierarchy level accepted as matched; lower results are partial. / matchedとして受け入れる最小階層。下位候補はpartial。",
              "maximum": 8,
              "minimum": 1,
              "type": [
                "integer",
                "null"
              ]
            },
            "postal_code": {
              "description": "Optional postal-code evidence. / 任意の郵便番号根拠。",
              "pattern": "^\\d{3}-?\\d{4}$",
              "type": [
                "string",
                "null"
              ]
            },
            "provider": {
              "default": "auto",
              "description": "Geocoder provider selection. / 地理コードプロバイダ。",
              "enum": [
                "auto",
                "local_jageocoder"
              ],
              "type": "string"
            }
          },
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "candidate_count": {
            "type": "integer"
          },
          "candidates": {
            "items": {
              "properties": {
                "address_id": {
                  "type": [
                    "integer",
                    "string",
                    "null"
                  ]
                },
                "confidence": {
                  "type": "number"
                },
                "granularity": {
                  "type": "string"
                },
                "latitude": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "longitude": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "match_completeness": {
                  "type": "string"
                },
                "match_level": {
                  "type": "integer"
                },
                "normalized": {
                  "type": "string"
                },
                "reasons": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "source": {
                  "type": "string"
                },
                "unmatched_tail": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "dictionary_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "geocoder_status": {
            "type": "string"
          },
          "matched": {
            "type": [
              "string",
              "null"
            ]
          },
          "minimum_acceptable_level": {
            "type": [
              "integer",
              "null"
            ]
          },
          "precision_satisfied": {
            "type": "boolean"
          },
          "status": {
            "type": "string"
          },
          "type": "object",
          "upstream_matched": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "verified_level": {
            "type": [
              "integer",
              "null"
            ]
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}