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 every ordinance and ships a hosted, always-current API plus change alerts so PMS, booking-engine and channel-manager vendors stay correct.

Try the calculatorAPI docs
  • 61 municipalities covered
  • Open-source core (MIT)
  • JST-correct dates
  • 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 every ordinance

We monitor accommodation-tax rules nationwide and fold each change into the dataset.

Hosted API

An always-current 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, always-current API and a machine-readable change feed.

Recent data changes

Get change alerts →
  1. Six new municipal taxes (MIC consent 2026-06-30): Tomakomai 3% from 2027-04-01 and Kitahiroshima 3% from 2027-10-01 (each replacing the Hokkaido prefectural tiers there), Wakkanai flat ¥200 stacking on the prefectural tax from 2027-03-01, Yamagata City 3% from 2027-04-01 (prefecture's first), and Fujiyoshida + Fujikawaguchiko flat ¥200 from 2027-04-01 (Yamanashi's first).
  2. Tokyo: from 2027-04-01 the accommodation tax becomes a flat 3% of the nightly charge (no cap); the exempt threshold rises from under ¥10,000 to under ¥13,000 per person per night; hostels and minpaku join the scope (Minister of Internal Affairs consent 2026-06-30).
  3. Baseline: initial published accommodation-tax dataset (DATA_VERSION 2026.06).