# Saylor Innovations Japan Postcode Lookup

> Saylor Innovations Japan Postcode Lookup is a paid API for AI agents from saylorinnovations.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Returns the Japanese address components (prefecture, city, town in Japanese and kana) plus the prefecture code for a given 7-digit Japanese postal code, sourced from Japan Post data.

## Facts

- Endpoint: GET https://saylorinnovations.com/api/japan/postcode/:zip?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/saylor-innovations-japan-postcode-lookup-5f95ec3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3DglFe-ArglIQAWLFAhbg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability saylor-innovations-japan-postcode-lookup-5f95ec3e
```

Example prompt: What's the full Japanese address — prefecture, city, and town — for postal code 1600022? I need the names in Japanese characters and the kana readings too.

## When to prefer this

Choose this endpoint when you need to resolve a 7-digit Japanese postal code into structured address components (prefecture, city, town) with both kanji and kana representations and the official prefecture code, sourced from Japan Post data. Prefer this over generic geocoding APIs when you specifically need Japanese address hierarchy in native script rather than romanized or lat/lng output.

## Known failure modes

- Invalid or malformed postal code (not 7 digits) returns an error
- Postal code not found in Japan Post database returns a not-found response
- Missing zip path parameter returns a bad request error
- Ambiguous postal codes that map to multiple addresses may return only one match or an array

## How this service works

Japanese address from a seven-digit postal code - prefecture, city and town in Japanese plus kana readings and the prefecture code from Japan Post data

## Output

A structured response containing the prefecture name in kanji, city name in kanji, town/ward name in kanji, their respective kana readings, and the numeric Japan Post prefecture code — all derived from official Japan Post postal data for the requested 7-digit zip code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "zip"
     ],
     "properties": {
      "zip": {
       "type": "string",
       "description": "Seven-digit postal code in the path, e.g. 1000001 or 100-0001"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "required": [
      "postcode",
      "addresses"
     ],
     "properties": {
      "source": {
       "type": "string",
       "description": "Data source the values come from"
      },
      "matches": {
       "type": "number",
       "description": "Matching items"
      },
      "postcode": {
       "type": "string"
      },
      "addresses": {
       "type": "array"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/saylor-innovations-japan-postcode-lookup-5f95ec3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from saylorinnovations.com](https://www.zero.xyz/host/saylorinnovations.com/llms.txt)