Jurisdictions browser

Open Jurisdictions in the left navigation. The landing view is a directory of countries with summary stat cards (Countries, Regions, Cities, Active) across the top. Use the search box to filter by country name, code, or ISO country code, then click a country to open it.

1. 1
   Search to a country

   Type a name or code in the search box (for example “Spain” or “ES”) and click the matching row.
2. 2
   Drill into sub-jurisdictions

   On the country's Overview tab, filter and click into its regions and cities. A breadcrumb at the top tracks your path — click any ancestor to jump back up, or use Back to step up one level.
3. 3
   Open the calculator with it selected

   The “Validate a stay” card carries an Open calculator button that pre-selects the current jurisdiction, so you can test a real stay in one click.

Once a jurisdiction is open, its data is split across tabs. Everyone sees three:

• Overview — a summary of the jurisdiction: its place in the hierarchy, its child jurisdictions, the rates that apply (including inherited ones), the regulatory sources behind them, and a sample 3-night, 200-per-night hotel calculation so you can see the stack resolve to real numbers.
• Rates — every tax rate attached directly at this jurisdiction, with its category, value, basis, and effective window.
• Rules — the rules attached here (exemptions, caps, overrides, surcharges, reductions) that adjust those rates.

This is the most important idea on the screen. A city rarely carries every tax that applies to a stay there — many are levied higher up. TaxLens models additive stacking: country VAT, a state or provincial lodging tax, and a city occupancy tax are each their own rate, and they all fire and sum.

The Overview tab shows the effective set — the rates that actually apply to a stay here, including those inherited from ancestor jurisdictions. Inherited rates are labelled with the ancestor they come from, so you can tell a city-level surcharge apart from the national VAT it stacks on top of.

For regular members and admins alike, this screen is a reference: you can search, drill, and inspect, but tax rates and rules are platform-global and not editable per organization. The calculator engine is identical across every tenant by design — so what you read here is exactly what your calculations and invoices use.

Everything the screen shows is available over the API, too. A few read-only calls back the views directly:

To go deeper on the model, see Jurisdictions and Rules. To turn a lookup into a number, head to the calculator.