Why We Open-Sourced a Japanese Accommodation Tax Calculator
Table of Contents
Every few months another operator sends me the same message: “wait, how much accommodation tax am I supposed to be charging in [city]?” Every time, the honest answer is “it depends which city, which band, and whether you’re calculating off the room rate or the total price.” Japan handles this differently in every place, and that got annoying enough that we wrote code to solve it for ourselves. Then we decided to open-source it.
TL;DR
- Japan has no single national accommodation tax. Individual prefectures, cities and towns levy it locally, and each sets its own rules by ordinance. Fixed-amount taxes are calculated per guest per night. Percentage-based jurisdictions calculate against the locally defined accommodation charge instead. For example, from April 1, 2026, Kutchan collects a combined town–prefectural accommodation tax totaling 3%, with Hokkaido’s share included.
- Tokyo, Osaka Prefecture and Kyoto City currently use fixed amounts per guest per night, with different price thresholds. Kutchan uses a percentage.
- Don’t assume an OTA has handled the tax. For each platform and property, check three things: whether the guest already paid the tax, whether the platform remitted it, and whether any tax the platform collected was passed through to you. Collect only what’s unpaid, and remit whatever you’re still responsible for under the local rules.
- A common mistake is using a base amount that doesn’t match the local definition of the accommodation charge. In Tokyo, Osaka Prefecture and Kyoto City, mandatory cleaning fees and accommodation-related service charges are included, while meals and consumption tax are excluded.
japan-stay-taxis an open-source library that encodes these rules jurisdiction by jurisdiction, with dated sources for its data. It cuts down how much operators and developers have to reimplement. Rates change, though, so check official sources before you file or remit.
What Problem Does Accommodation Tax Create for Operators?
“Accommodation tax” isn’t one tax. It’s a patchwork of local ones.
- Tokyo currently taxes hotel and ryokan stays, based on the tax-exclusive accommodation charge per person per night: no tax under ¥10,000, ¥100 for ¥10,000 to under ¥15,000, and ¥200 at ¥15,000 and up. That changes on 2027-04-01. Tokyo will extend the tax to hotels, ryokan, simple lodgings and minpaku, and switch to a flat 3% of the accommodation charge, with no tax where the tax-exclusive accommodation charge per person per night is below ¥13,000. From April 1, 2027, operators of minpaku covered by the revised rules must collect and remit accommodation tax on taxable stays (Tokyo Metropolitan Government Bureau of Taxation, accommodation tax revision FAQ).
- Kyoto City generally taxes all lodging guests, including minpaku guests. School trips and certain preschool overnight stays are exempt. Since 2026-03-01, the tax per person per night, based on the tax-exclusive accommodation charge per person per night, is (Kyoto City FAQ for accommodation operators):
- under ¥6,000: ¥200
- ¥6,000 to under ¥20,000: ¥400
- ¥20,000 to under ¥50,000: ¥1,000
- ¥50,000 to under ¥100,000: ¥4,000
- ¥100,000 or more: ¥10,000
- Osaka Prefecture (the whole prefecture, not just Osaka City) uses bands too. Its tax-free floor and rate steps differ from Tokyo’s (Osaka Prefecture accommodation tax).
- Percentage-based jurisdictions charge a share of the price instead of a fixed amount. From April 1, 2026, Kutchan in Hokkaido collects a combined town–prefectural accommodation tax totaling 3%, with Hokkaido’s share included (Kutchan Town accommodation tax).
New municipalities keep adopting the tax, too, so this isn’t a fixed list you can memorize once and forget.
If you run one property in one city, you can probably keep the rule in your head. The trouble starts when you run properties in more than one city, when a city updates its bands, or when someone new joins your team and doesn’t know the local quirks yet.
Why Is This So Easy to Get Wrong?
One reason is that you can’t assume the OTA has handled it, and “handled” can mean different things. A platform might:
- collect the tax from the guest and remit it itself,
- collect it and pass it through to you to remit, or
- not collect it at all.
Airbnb, for example, documents separate pass-through payouts for eligible custom taxes (Airbnb: Taxes for hosts).
So for each platform and property, check three things: whether the guest already paid the tax, whether the platform remitted it, and whether any collected tax was passed to you. Collect from the guest only what’s still unpaid, or you risk charging them twice. Then the registered special collector, usually the operator, remits whatever it remains responsible for, following the jurisdiction’s prescribed calculation rules and filing/payment deadlines. In Tokyo, for instance, the previous month’s tax normally has to be declared and paid by the end of the month, with specified exceptions. All of this means the calculation logic often lives in your spreadsheet, your PMS, or your head, not in the platform.
The other common mistake, which we’ve seen and made ourselves early on, is using a base amount that doesn’t match the local definition of the accommodation charge. In Tokyo, Osaka Prefecture and Kyoto City, mandatory cleaning charges count toward the taxable accommodation charge, and so do accommodation-related service charges. Meals and consumption tax don’t. If you leave out a mandatory cleaning fee, or fold in meals and tax, you can land in the wrong band, or in a percentage-based jurisdiction you’ll simply compute the wrong amount. Either way, you’ve over-collected from guests or under-remitted to the local authority, and both are bad conversations to have later.
How Does japan-stay-tax Work?
japan-stay-tax encodes each jurisdiction’s accommodation tax structure (flat, banded or percentage) in one open-source library. The calculation is defined once and reused, instead of being worked out again for every jurisdiction, by every person, in every spreadsheet. You no longer hand-code “if Tokyo, check thresholds A/B/C” logic each time you build a booking flow or reconcile a monthly filing. You call the library, and it applies the right structure for that jurisdiction.
It’s on GitHub: github.com/benstaydev/japan-stay-tax. If you’re a developer building a booking engine, a PMS integration or an internal reconciliation tool for Japanese short-term rentals, you can pull it in directly instead of reimplementing city rules from scratch.
Who Should Use This Tool?
The main audience is anyone writing code that touches Japanese accommodation tax: developers building booking systems, channel managers or finance tools for hosts and property managers who operate in several cities. If you’re a solo host with one listing in one city, knowing your local rule by heart may be all you need. That’s a perfectly reasonable outcome, and we’d rather say so plainly than oversell a library you don’t need.
A shared, maintained calculation library becomes more useful as you expand across jurisdictions or automate billing. In our experience, the turning point is when you add a second city, hand tax calculation off to someone else on your team, or build any automated pricing or invoicing flow. That’s when a manually maintained rule set quietly goes stale.
What Does It Not Do?
It calculates the tax. It doesn’t file or remit anything for you. japan-stay-tax covers the “how much, under which city’s rule” part of the problem. Collecting the tax from guests, tracking it against your bookings, and remitting it to each municipality on its schedule is still a separate process. We built the library to remove the guesswork about which band applies, not to replace your filing workflow.
FAQ
Q: Does every city in Japan charge an accommodation tax?
No. Accommodation tax is set at the prefecture, city or town level, not nationally, and each place decides whether to adopt it. Some jurisdictions have adopted it, others haven’t, and new ones add it from time to time. There’s no single national rate or rule.
Q: Is the accommodation tax included in what OTAs like Airbnb pay me?
Not necessarily. Check three things: whether the guest already paid the tax through the platform, whether the platform remitted it, and whether any tax it collected was passed through to you in your payout. Airbnb, for example, documents separate pass-through payouts for eligible custom taxes. Collect from the guest only what hasn’t been paid, and remit whatever you, as the registered collector, are still responsible for. Confirm this for each platform and property rather than assuming either way.
Q: What accommodation-tax calculation mistake have you encountered?
One mistake we have encountered is applying the wrong base amount. For example, leaving out mandatory cleaning fees, which Tokyo, Osaka Prefecture and Kyoto City all include in the accommodation charge, or including meals and consumption tax, which all three exclude.
Sources
- 宿泊税改正に関するよくあるご質問 — Tokyo Metropolitan Government Bureau of Taxation
- よくある質問:宿泊施設を経営されている方向け(徴収について) — Kyoto City
- 大阪府の宿泊税 — Osaka Prefecture
- 倶知安町の宿泊税について — Kutchan Town
- Taxes for hosts — Airbnb
This post is for informational purposes only and does not constitute legal or tax advice. Please consult a qualified professional for your specific situation.
Comments