Accommodation tax API · nationwide
Japan accommodation tax — calculation & change tracking, as an API.
Kyoto's 5-tier revision, Kutchan's percentage rate, 28 new municipalities in the June 2026 update alone. Yadozei tracks the ordinances and ships a hosted API plus change alerts that help PMS, booking-engine and channel-manager vendors keep up.
- 66 municipalities covered
- Open-source core (MIT)
- Dates in Japan time (JST)
- Rate-change alerts
POST /v1/calculate
{ "areaId": "tokyo", "ratePerNight": 20000, "guests": 2 }
200 OK
{
"perNightTax": 200,
"stayTotal": { "perPerson": 200, "total": 400 },
"currency": "JPY",
"dateUsed": "2026-06-14"
}We track the ordinances
We monitor accommodation-tax rules nationwide and fold the changes we find into the dataset.
Hosted API
A continuously updated endpoint for PMS, booking-engine and channel-manager vendors.
Open core, run for you
Calculation is the MIT japan-stay-tax library; we add a supported operations layer on top.
Change alerts
A change feed and email notices so a rate revision never slips past you.
What is Japan's accommodation tax?
Japan's accommodation tax (宿泊税) is a local lodging tax levied by some prefectures and municipalities on paid stays at hotels, ryokan, vacation rentals and similar lodging. Most rules are based on the pre-tax, room-only charge per person per night, applied as a fixed amount or a percentage. Rates, thresholds and start dates vary by municipality and change often.
The calculation engine is the open-source japan-stay-tax library (MIT). Yadozei is the commercial layer on top: a supported, continuously maintained API and a machine-readable change feed.
Recent data changes
Get change alerts →- Nagasaki City: from 2027-04-01 (scheduled) the tiers become under ¥6,000 = ¥100, ¥6,000–19,999 = ¥300, ¥20,000+ = ¥500 per person per night, replacing under ¥10,000 = ¥100 / ¥10,000–19,999 = ¥200 / ¥20,000+ = ¥500 (Minister of Internal Affairs consent 2026-09-30). Exemptions unchanged.
- Three new municipal taxes (Minister of Internal Affairs consent 2026-09-30): Kagoshima City ¥200 flat per person per night from 2027-04-01 (scheduled; exempt school trips); Ibusuki City ¥200 flat from 2027-04-01 (scheduled; exempt children through the March 31 after turning 12, and school trips); Shirahama Town (Wakayama) from 2027-03-01: under ¥10,000 = ¥200, ¥10,000–19,999 = ¥300, ¥20,000–49,999 = ¥500, ¥50,000+ = ¥1,000 (exempt school trips, under-12s, disaster-affected guests). Neither Kagoshima nor Wakayama prefecture has a prefecture-wide tax.
- Notes clarified, no rate or date change: in Kutchan, and in Niseko from 2026-11-01, the Hokkaido prefectural tiers legally still apply but the town tax is 3% minus the prefectural amount, collected as one 3% charge by the town. The dataset keeps a single 3% town rule, so the breakdown does not split out the prefectural share.
- Correction to seq 3 — rates and dates unchanged. The 2026-06-30 consent batch is MIC release 01zeimu02_02000463 (02000445 is the 2026-02-13 Okinawa batch); Kitahiroshima and Fujikawaguchiko source links updated. Tomakomai/Kitahiroshima wording corrected: the Hokkaido prefectural tiers remain in force there but are embedded in the 3% (city tax = 3% minus the prefectural amount, 道税控除方式), so the single 3% rule and the totals stand.
- Two new municipal taxes: Nago City (Okinawa) 1.2% capped at ¥1,200, stacking on the prefecture's 0.8%/¥800, from 2027-02-01 (MIC consent 2026-06-30; the sixth Okinawa municipality with its own tax), and Unzen City (Nagasaki) ¥100 under ¥5,000 / ¥350 from ¥5,000 per person per night from 2027-04-01 (MIC consent 2026-08-28).