# Torify — Full Endpoint Reference

> Japanese locale APIs for AI agents (42 endpoints). $0.02/call via x402 or free via MCP.

## All Endpoints (42 total — $0.02/call each, except /v1/whoami which is free)

### Calendar & Dates
- /v1/wareki/convert — Convert between Japanese era dates (令和/平成/昭和/大正/明治) and Gregorian
- /v1/holiday/check — Japanese public holiday check + annual list + next business day
- /v1/legal-holiday/check — Statutory rest day (法定休日) per Labor Standards Act Art. 35
- /v1/age/calculate — Age, school year, era-age with April 1 cutoff rule

### Legal & Tax
- /v1/invoice/validate — Format check for Japanese qualified invoice T-numbers
- /v1/invoice/verify — Verify T-number against NTA public registry (registrant name + address)
- /v1/tax/calculate — Consumption tax: 10% standard, 8% reduced, rounding modes
- /v1/eltax/check — Electronic bookkeeping law (電子帳簿保存法) compliance checklist

### Corporate & KYC
- /v1/houjin/lookup — Japanese corporate number (法人番号) → company name, address, status (NTA)
- /v1/mynumber/validate — My Number format validation (Verhoeff checksum)
- /v1/industry/lookup — JSIC Rev.14 industry classification code lookup

### Geo & Address
- /v1/postal/lookup — Postal code (7 digits) → prefecture, city, town (zipcloud)
- /v1/address/normalize — Free-form Japanese address → prefecture/city/town
- /v1/region/lookup — JIS X 0402 prefecture/city code lookup
- /v1/coordinate/convert — WGS84 ↔ JGD2011 coordinate conversion
- /v1/geo/geocode — Address → lat/lng (GSI)
- /v1/geo/reverse-geocode — lat/lng → municipality + town (GSI)

### Finance & Banking
- /v1/bank/lookup — Zengin bank code → bank name + branch (1,152 banks)
- /v1/bank/search — Search banks/branches by partial name (kanji/kana/romaji)
- /v1/bank/list — Paginated list of all Japanese financial institutions
- /v1/bank/transfer/validate — Bank transfer account format validation (全銀 format)
- /v1/yucho/convert — Japan Post account (記号・番号) → bank transfer format
- /v1/payment/3ds/check — 3D Secure 2.0 requirement by MCC and BIN

### Text & Names
- /v1/kanji/to-kana — Kanji → Hiragana/Katakana (engine upgrade in progress · ETA 2026-06-01)
- /v1/kanji/normalize — Non-standard kanji (IVS, old form) → standard form
- /v1/kana/convert — Hiragana ↔ Katakana ↔ Half-width kana
- /v1/text/normalize — Full-width ↔ half-width (NFKC / ASCII)
- /v1/name/romanize — Japanese name → Hepburn romanization (passport-style)
- /v1/name/validate — Name characters vs Jinmeiyo Kanji list
- /v1/name/split — Full name → surname / given name

### Identity & Validation
- /v1/passport/validate — Japanese passport number format
- /v1/insurance/validate — Social insurance number format
- /v1/plate/validate — License plate / VIN format
- /v1/barcode/validate — JAN code / ISBN-13 validation
- /v1/school-code/validate — MEXT 13-char school code
- /v1/phone/validate — Phone validation + E.164 normalization

### Legal Data
- /v1/law/search — Japanese laws/regulations via e-Gov API v2

### Diagnostics
- /v1/whoami — Self IP / country / region (free, no auth)
- /v1/trial/signup — Free trial key (100 calls/month with email signup)

Bulk variants: /v1/wareki/convert/bulk (free, 60 req/min/IP), /v1/invoice/validate/bulk (Trial key or x402 $0.50/req)

## Quick Examples (curl)

# Free trial signup
curl -X POST https://torify.dev/v1/trial/signup -H "Content-Type: application/json" -d '{"email":"you@example.com"}'

# Wareki conversion
curl -H "X-Trial-Key: trial_xxx" "https://torify.dev/v1/wareki/convert?direction=g2w&date=2026-05-14"

# Corporate number lookup
curl -H "X-Trial-Key: trial_xxx" "https://torify.dev/v1/houjin/lookup?number=7000012050002"

# Invoice T-number verification
curl -H "X-Trial-Key: trial_xxx" "https://torify.dev/v1/invoice/verify?number=T1180301018771"

# Postal code lookup
curl -H "X-Trial-Key: trial_xxx" "https://torify.dev/v1/postal/lookup?zipcode=100-0001"

## OpenAPI Schema

Full schema: https://torify.dev/openapi.json

## Agent Card (A2A)

https://torify.dev/.well-known/agent.json