Skip to content
HALOWERK

Trade Operations

japan post postcode localities

Japan postal code lookup returns the listed prefecture, municipality and town names for one geographic postcode. Use it when an agent needs official address candidates.

POST https://handel.halowerk.com/v1/japan-post-postcode-localities

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
postal_codestringYes
limitintegerNo
Show full input schema
{
  "type": "object",
  "properties": {
    "postal_code": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "postal_code"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "postal_code": "1000001"
}

Result & documentation

Show published result schema
{
  "$ref": "https://handel.halowerk.com/v1/japan-post-postcode-localities/schema#/outputSchema"
}

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-20 UTC.

More endpoints in this hub

All endpoints in this hub โ†’