Accommodation tax infrastructure for every stay

Calculate, persist booking evidence, issue invoices, report liabilities, and monitor regulatory change across every lodging-tax workflow.

Sign up Guides
tax decision packet
US-NY-NYC / 3 nights / hotel
$87.37
tax due
NY state
$30.00
NYC occupancy
$44.06
Fees
$10.50
snapshot
invoice
report
245
countries/territories
1,100+
active rates
700+
rules/exemptions
1,000+
jurisdictions

Tax lifecycle

TaxLens is not just a calculation endpoint. It carries the same tax decision from quote to booking evidence, invoice issuance, liability reporting, and regulatory monitoring.

01
Quote the stay

Calculate

Resolve the jurisdiction, stack every applicable tax layer, and return a deterministic breakdown before checkout.

02
Freeze the evidence

Persist

Store the confirmed booking, idempotency key, buyer context, and immutable tax snapshot for downstream finance work.

03
Create fiscal documents

Issue

Project the booking into commercial invoices, self-billing flows, credit notes, and UBL/XML-ready documents.

04
Reconcile liability

Report

Pull period liability reports from issued invoice snapshots so tax teams can remit by jurisdiction and category.

05
Keep rules current

Monitor

AI monitoring detects source changes, while human review approves updates with authority names and legal references.

Who TaxLens helps

The same platform supports different buyers because lodging tax risk appears in different parts of the operating model.

1

OTAs & marketplaces

Booking.com, Airbnb-style platforms, bedbanks, and merchant-of-record flows.

Route marketplace facilitator, merchant-of-record, commission VAT, and self-billing scenarios without separate tax logic per channel.

Reduce launch friction when adding new jurisdictions or supplier models.

merchant-of-record and channel context travel with each calculation.

2

Hotel groups

Multi-property brands and regional hotel operators.

Give front-desk and finance teams one source of truth for quotes, invoices, credit notes, and monthly liability reporting.

Cut manual spreadsheet review before close and reduce under/over-collection risk.

booking snapshots keep historical invoices stable after rule changes.

3

PMS & property managers

Property managers, channel managers, and PMS platforms with many units.

Map every unit once, inherit property tax drivers, and calculate stay tax consistently across direct, OTA, and owner channels.

Ship compliant tax workflows without building local rules into the PMS.

property defaults fill booking inputs without rewriting historical records.

A platform built around the hard parts

Rates are only the visible edge. TaxLens connects address resolution, additive tax logic, booking evidence, fiscal documents, and reporting into one operating layer.

address -> code

Jurisdiction resolution

Use a known jurisdiction code or resolve an address into the country, state, city, district, and special-zone path.

additive stack

Layered tax engine

Country, regional, city, and district rates fire independently so remittance lines remain separate and auditable.

frozen evidence

Booking snapshots

Confirmed bookings preserve the exact tax response, property drivers, buyer context, and issuer defaults used at sale time.

380 / 381 / 389

E-invoicing system of record

Issue commercial invoices, self-billed invoices, and credit notes with legal issuer fields and UBL/XML output.

issued period

Liability reporting

Report tax liability from issued invoice snapshots, not recalculated bookings, so finance sees stable remittance numbers.

approval queue

Human-reviewed monitoring

Monitoring agents propose rate changes; reviewers approve drafts with source URLs, authority names, and legal references.

Show the hard cases, then keep the evidence

One request shape handles percentage taxes, flat nightly fees, per-person city taxes, tax-on-tax bases, and property-type rules. Booking APIs preserve the final snapshot for invoices, credit notes, and liability reports.

State + city stack

New York City

NY state sales tax, NYC hotel occupancy tax, MCTD, nightly unit fee, and convention fee in one response.

Currency
USD
Result
$87.37 tax
US-NY-NYC request
curl -X POST https://api.taxlens.getdynamiq.ai/v1/tax/calculate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <your-api-key>" \
  -d '{
  "jurisdiction_code": "US-NY-NYC",
  "stay_date": "2026-06-15",
  "nightly_rate": 250,
  "currency": "USD",
  "nights": 3,
  "number_of_guests": 2,
  "property_type": "hotel"
}'
Response excerpt
{
  "jurisdiction": {
    "code": "US-NY-NYC",
    "name": "New York City",
    "path": "US.NY.NYC"
  },
  "tax_breakdown": {
    "total_tax": "87.37",
    "effective_rate": "0.1165",
    "currency": "USD",
    "subtotal_excluding_tax": "750",
    "subtotal_including_tax": "837.37",
    "components": [
      {
        "category_code": "vat_standard",
        "jurisdiction_code": "US-NY",
        "rate": 0.04,
        "tax_amount": "30.00"
      },
      {
        "category_code": "municipal_pct",
        "jurisdiction_code": "US-NY-NYC",
        "rate": 0.00375,
        "tax_amount": "2.81"
      },
      {
        "category_code": "occ_pct",
        "jurisdiction_code": "US-NY-NYC",
        "rate": 0.05875,
        "tax_amount": "44.06"
      },
      {
        "category_code": "occ_flat_night",
        "jurisdiction_code": "US-NY-NYC",
        "rate_type": "tiered",
        "tax_amount": "6.00"
      },
      {
        "category_code": "convention_flat",
        "jurisdiction_code": "US-NY-NYC",
        "rate": 1.5,
        "tax_amount": "4.50"
      },
      {
        "category_code": "vat_standard",
        "jurisdiction_code": "US",
        "rate": 0,
        "tax_amount": "0.00"
      }
    ]
  },
  "total_with_tax": "837.37",
  "collection_info": {
    "who_collects": "property",
    "taxable_base": "room_rate"
  }
}

Trust layer

TaxLens earns confidence through coverage discipline, auditable source history, immutable fiscal records, and human review. No unapproved customer-logo claims, no hand-wavy proof.

Human-reviewed monitoring

Agents detect potential changes, operators approve drafts, and each active row keeps effective dates, authority names, legal references, and source URLs.

245 countries/territories

Tracked for country-level monitoring and coverage intelligence.

1,100+ active rates

Layered lodging, VAT/GST, tourism, city, and special-zone rates.

700+ rules/exemptions

Age, stay length, property type, channel, and supplier-side logic.

1,000+ jurisdictions

Country, state, city, district, and special-zone calculation paths.

Replace fragmented lodging tax workflows with one lifecycle.

Start with the API, then keep calculation evidence, invoices, liability reports, and monitoring in the same system.

Sign up API docs