Api Endpoint

Japan Postal Lookup

Japanese postal-code lookup and reverse lookup. Keywords: Japanese postal lookup, Japan Post postal code, postal code reverse lookup, 日本郵便番号検索. Use a postal code or prefecture/city/ward/town components against the local Japan Post snapshot. / 通过邮编或都道府县、市区町村、区、町名字段,在本地 Japan Post 数据中进行日本邮编反查。

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/postal-lookup
MIME type
Not provided
First seen
2026-10-16T01:50:10.647Z
Last seen
Tags
japan, postal-code, lookup, reverse-lookup, japan-post

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": "0xe4A4E5B226bE71e7b6eD523bc7a91089c770572F"
  }
]

Observed health

Status
Reachable
Latest latency
530 ms
Average latency
926 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,
      "description": "Provide postal_code or one or more administrative components. / postal_codeまたは行政区・町域の項目を指定します。",
      "properties": {
        "city": {
          "description": "City component. / 市区町村。",
          "type": [
            "string",
            "null"
          ]
        },
        "county": {
          "description": "County component when applicable. / 郡。",
          "type": [
            "string",
            "null"
          ]
        },
        "max_results": {
          "default": 10,
          "description": "Maximum returned candidates. / 返却候補数の上限。",
          "maximum": 50,
          "minimum": 1,
          "type": "integer"
        },
        "postal_code": {
          "description": "Japan postal code to expand or verify. / 照合・展開する日本郵便番号。",
          "pattern": "^\\d{3}-?\\d{4}$",
          "type": [
            "string",
            "null"
          ]
        },
        "prefecture": {
          "description": "Prefecture component. / 都道府県。",
          "type": [
            "string",
            "null"
          ]
        },
        "town": {
          "description": "Town or chome component. / 町域・町名。",
          "type": [
            "string",
            "null"
          ]
        },
        "ward": {
          "description": "Ward component. / 区。",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "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,
          "description": "Provide postal_code or one or more administrative components. / postal_codeまたは行政区・町域の項目を指定します。",
          "properties": {
            "city": {
              "description": "City component. / 市区町村。",
              "type": [
                "string",
                "null"
              ]
            },
            "county": {
              "description": "County component when applicable. / 郡。",
              "type": [
                "string",
                "null"
              ]
            },
            "max_results": {
              "default": 10,
              "description": "Maximum returned candidates. / 返却候補数の上限。",
              "maximum": 50,
              "minimum": 1,
              "type": "integer"
            },
            "postal_code": {
              "description": "Japan postal code to expand or verify. / 照合・展開する日本郵便番号。",
              "pattern": "^\\d{3}-?\\d{4}$",
              "type": [
                "string",
                "null"
              ]
            },
            "prefecture": {
              "description": "Prefecture component. / 都道府県。",
              "type": [
                "string",
                "null"
              ]
            },
            "town": {
              "description": "Town or chome component. / 町域・町名。",
              "type": [
                "string",
                "null"
              ]
            },
            "ward": {
              "description": "Ward component. / 区。",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "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"
          },
          "data_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "matches": {
            "items": {
              "properties": {
                "city": {
                  "type": "string"
                },
                "confidence": {
                  "type": "number"
                },
                "kana": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "postal_code": {
                  "type": "string"
                },
                "prefecture": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                },
                "town": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "postal_code_match": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "query": {
            "type": "object"
          },
          "record_count": {
            "type": "integer"
          },
          "status": {
            "type": "string"
          },
          "type": "object",
          "warnings": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}