# Torify

> Japanese locale APIs for AI agents — invoice compliance, corporate verification, address normalization, wareki conversion.

Torify provides 36 API endpoints that handle Japanese-specific complexity for AI agents operating in Japan. All endpoints return structured JSON with confidence scores. Pay-per-call via x402 ($0.02/call USDC on Base) or free via MCP.

## Core Endpoints (Tier S)

- GET /v1/houjin/lookup?number={13-digit-corporate-number} — Corporate number → name, address, status, confidence, verified_at (NTA official API)
- GET /v1/invoice/verify?number={T+13-digits} — Invoice number → NTA registration check, confidence score (0.99=verified, 0.5=cancelled, 0=not found)
- GET /v1/address/normalize?address={raw-japanese-address} — Raw address → structured prefecture/city/rest components
- GET /v1/wareki/convert?direction=g2w&date=YYYY-MM-DD — Gregorian ↔ Japanese era date (Meiji/Taisho/Showa/Heisei/Reiwa)
- GET /v1/name/romanize?name={katakana-name} — Japanese name → Hepburn romanization (passport-style)
- GET /v1/phone/validate?phone={japanese-phone} — Phone number → E.164 format + area code info

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

invoice/validate, invoice/verify, houjin/lookup, postal/lookup, wareki/convert,
name/romanize, name/validate, name/split, kanji/to-kana, kanji/normalize,
kana/convert, text/normalize, tax/calculate, holiday/check, legal-holiday/check, school-code/validate, phone/validate,
address/normalize, bank/lookup, bank/search, bank/list, bank/transfer/validate, barcode/validate,
mynumber/validate, passport/validate, coordinate/convert, age/calculate,
license/validate, insurance/validate, region/lookup, yucho/convert,
plate/validate, industry/lookup, eltax/check, payment/3ds/check, whoami (free)

Bulk variants (free, rate-limited 60 req/min/IP): /v1/wareki/convert/bulk, /v1/invoice/validate/bulk

## Authentication

- MCP (free): Add to Claude Desktop config: {"type":"http","url":"https://torify-mcp.torify.workers.dev"}
- x402: Attach X-PAYMENT header with USDC payment payload (see https://x402.org/spec)
- API Key: X-API-Key header — Pro $49/month, Enterprise $499/month (email contact@torify.dev)

## OpenAPI Schema

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

## Agent Card (A2A)

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