API v1 / schema 1.0.0

Tourist tax addresses and defaults

POST /v1/resolve · defaults:resolve

Request defaults for a property.

countryCode is required. Supply on (YYYY-MM-DD) and the supported accommodationType to resolve date- and category-dependent defaults. Address fields provide context. Independently confirmed jurisdictionIds or officialCodes: [{scheme, value}] establish authoritative matches.

curl 'https://api.touristtaxtools.com/v1/resolve' \
  -H "Authorization: Bearer $TOURISTTAXTOOLS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "countryCode": "IT",
    "address": {
      "street": "Piazza della Rotonda",
      "city": "Roma",
      "postalCode": "00186"
    },
    "on": "2026-10-26",
    "accommodationType": "hotel"
  }'

Resolution response

The versioned envelope includes schemaVersion, status, countryCode, snapshotId, jurisdictions, rules, defaults, reasons and coverage.

Defaults are available only for a resolved result with sufficient published coverage and supported rule inputs. Otherwise defaults is null. Do not infer no tax from an empty rule list.

{
  "schemaVersion": "1.0.0",
  "status": "unknown",
  "countryCode": "IT",
  "snapshotId": null,
  "jurisdictions": [],
  "rules": [],
  "evidence": [],
  "defaults": null,
  "reasons": [
    "country_unpublished"
  ],
  "coverage": {
    "status": "unknown",
    "summary": "No published country snapshot",
    "gaps": [
      "country_unpublished"
    ]
  }
}

Try the public property lookup ↗

For exact official address matching, qualified policies and explicit stay inputs, see the separate v2 quote contract. The public lookup continues to use v1.