API v1 / schéma 1.0.0

Adresses et valeurs par défaut de la taxe de séjour

POST /v1/resolve · defaults:resolve

Demander les valeurs par défaut pour une propriété.

countryCode est requis. Fournissez on (YYYY-MM-DD) et les formats pris en charge accommodationType résoudre les valeurs par défaut dépendant de la date et de la catégorie. Les champs d'adresse fournissent le contexte. Confirmé de manière indépendante jurisdictionIds ou officialCodes: [{scheme, value}] établir des correspondances faisant foi.

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"
  }'

Réponse de résolution

L'enveloppe versionnée inclut schemaVersion, status, countryCode, snapshotId, jurisdictions, rules, defaults, reasons et coverage.

Les valeurs par défaut sont disponibles uniquement pour un résultat résolu avec une couverture publiée suffisante et des entrées de règle prises en charge. Sinon defaults est nul. Ne déduisez pas l'absence de taxe d'une liste de règles vide.

{
  "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"
    ]
  }
}

Essayez la recherche de propriété publique ↗

Pour une correspondance exacte de l'adresse officielle, des politiques qualifiées et des informations explicites sur le séjour, voir le document séparé contrat de devis v2. La recherche publique continue d'utiliser v1.