ToolAssay

Japanese postal-code lookup and reverse 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 数据中进行日本邮编反查。

Answeringour last check, 2026-09-24
1 of 1checks answered this week
362 msmedian answer time
$0.001listed price per call
$0.001price it asked us

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://api.jpverify.com/jp-address/postal-lookup

CategoryCode and developer
Provider hostapi.jpverify.com
Networkseip155:8453
Payment schemesexact
Self-reported calls, 30 days1 from 1 payers (the provider's figure, not ours)

Our checks, last 30 days

DayResultHTTPAskedTime
2026-09-24 valid payment request 402$0.001 362 ms

Example input (from the provider)

{
  "body": {
    "max_results": 10,
    "postal_code": "100-0001"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$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\u307e\u305f\u306f\u884c\u653f\u533a\u30fb\u753a\u57df\u306e\u9805\u76ee\u3092\u6307\u5b9a\u3057\u307e\u3059\u3002",
          "properties": {
            "city": {
              "description": "City component. / \u5e02\u533a\u753a\u6751\u3002",
              "type": [
                "string",
                "null"
              ]
            },
            "county": {
              "description": "County component when applicable. / \u90e1\u3002",
              "type": [
                "string",
                "null"
              ]
            },
            "max_results": {
              "default": 10,
              "description": "Maximum returned candidates. / \u8fd4\u5374\u5019\u88dc\u6570\u306e\u4e0a\u9650\u3002",
              "maximum": 50,
              "minimum": 1,
              "type": "integer"
            },
            "postal_code": {
              "description": "Japan postal code to expand or verify. / \u7167\u5408\u30fb\u5c55\u958b\u3059\u308b\u65e5\u672c\u90f5\u4fbf\u756a\u53f7\u3002",
              "pattern": "^\\d{3}-?\\d{4}$",
              "type": [
                "string",
                "null"
              ]
            },
            "prefecture": {
              "description": "Prefecture component. / \u90fd\u9053\u5e9c\u770c\u3002",
              "type": [
                "string",
                "null"
              ]
            },
            "town": {
              "description": "Town or chome component. / \u753a\u57df\u30fb\u753a\u540d\u3002",
              "type": [
                "string",
                "null"
              ]
            },
            "ward": {
              "description": "Ward component. / \u533a\u3002",
              "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"
}

This page as JSON