API v1 / schema 1.0.0

Endereços e valores padrão da taxa turística

POST /v1/resolve · defaults:resolve

Solicitar padrões para uma propriedade.

countryCode é obrigatório. Fornecer on (YYYY-MM-DD) e os suportados accommodationType para resolver padrões dependentes de data e categoria. Campos de endereço fornecem contexto. Confirmado de forma independente jurisdictionIds ou officialCodes: [{scheme, value}] estabelecer correspondências autoritativas.

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

Resposta da resolução

O envelope versionado inclui schemaVersion, status, countryCode, snapshotId, jurisdictions, rules, defaults, reasons e coverage.

Padrões estão disponíveis apenas para um resultado resolvido com cobertura publicada suficiente e entradas de regras suportadas. Caso contrário defaults é nulo. Não inferir ausência de imposto a partir de uma lista de regras vazia.

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

Tente a verificação de propriedade pública ↗

Para correspondência exata de endereço oficial, políticas qualificadas e entradas de estadia explícitas, consulte o separado contrato de cotação v2. a pesquisa pública continua a usar v1.