Countries Without Tax Data
Learn about regions and countries that don’t return tax data.
The service doesn't return tax data for the regions and countries listed below.
When a transaction assigns tax liability to one of these regions or countries, the API response doesn't return calculated tax data. In these cases, the response returns fields such as "tax_amount": 0, indicating that no tax data is available.
Countries without tax data
The following regions and countries don't return tax data:
- Afghanistan (AF)
- Åland Islands (AX)
- Saint Barthélemy (BL)
- Bermuda (BM)
- Brunei (BN)
- Caribbean Netherlands (BQ)
- Bouvet Island (BV)
- Cocos (CC)
- Christmas Islands (CX)
- Western Sahara (EH)
- Falkland Islands (FK)
- French Guiana (GF)
- Guernsey (GG)
- Gibraltar (GI)
- Greenland (GL)
- South Georgia (GS)
- Hong Kong (HK)
- British Indian Ocean Territory (IO)
- Iraq (IQ)
- North Korea (KP)
- Kuwait (KW)
- Cayman Islands (KY)
- Libya (LY)
- Macau (MO)
- Montserrat (MS)
- Norfolk Islands (NF)
- Nauru (NR)
- Saint Pierre and Miquelon (PM)
- Pitcairn Islands (PN)
- Qatar (QA)
- Saint Helena (SH)
- Svalbard (SJ)
- San Marino (SM)
- Somalia (SO)
- Syria (SY)
- Turks and Caicos Islands (TC)
- French Southern and Antarctic Lands (TF)
- Tokelau (TK)
- Vatican City (VA)
- British Virgin Islands (VG)
- Wallis and Futuna (WF)
- Samoa (WS)
- Mayotte (YT)
Example: Hong Kong
The following example request and response demonstrates how the API behaves when a region or country doesn't return tax data.
Request
The following request creates a transaction with Hong Kong (HK) as the ship-to country:
{
"transaction": {
"currency_code": "EUR",
"ship_to_address": {
"country_code": "HK"
},
"transaction_lines": [
{
"product_class": "P",
"amount": 100,
"custom_id": "",
"ship_from_address": { "country_code": "HK" },
"seller_code": "seller"
}
],
"sellers": [
{
"seller_code": "seller",
"country": "HK",
"settings": {
"countries": {
"HK": {
"taxation": {
"is_seller_registered": true,
"physical": {
"is_physical_tax_enabled": true
}
}
}
}
}
}
]
}
}
Response
The API returns a response where the tax calculation data are present, but only "tax_amount": 0.00 is returned, indicating that no tax was calculated or applied:
{
"transaction": {
"ship_to_address": {
"country_code": "HK",
"tax_region": "HK"
},
"amount": 100.00,
"required_fields": {
"tax_required_fields": []
},
"tax_country_codes": "HK",
"tax_amount": 0.00,
"invoice_timestamp": "2026-01-15T17:31:29Z",
"tax_liability_owner_codes": "",
"transaction_lines": [
{
"reverse_charge": false,
"amount": 100.00,
"tax_rule_applied": "physical-tax",
"unit_price": 100.00,
"taxes": [],
"tax_amount": 0.00,
"tax_region": "HK",
"tax_exempt": true,
"tax_country_code": "HK",
"line_key": "dpS3KnFVsBaOeBgN",
"custom_id": "",
"tax_address_kind": "ship_to_address",
"ship_from_address": {
"country_code": "HK",
"tax_region": "HK"
},
"tax_engine": "oseries",
"invoice_status": "R",
"kind": "b2c",
"product_class": "P",
"custom_rules_applied": [],
"line_num": 1,
"is_seller_permanent": false,
"quantity": 1.000000000000,
"invoice_capable": false,
"total_amount": 100.00,
"seller_code": "seller",
"tax_entity_name": "Hong Kong",
"tax_supported": true
}
],
"discounts": [],
"product_classes": "P",
"billing_address": {
"country_code": "HK",
"tax_region": "HK"
},
"sellers": [
{
"settings": {
"countries": {
"HK": {
"taxation": {
"physical": {
"is_physical_tax_enabled": true
},
"is_seller_registered": true
}
}
}
},
"seller_code": "seller",
"country": "HK"
}
],
"tax_timestamp": "2026-01-15T17:31:29Z",
"total_amount": 100.00,
"currency_code": "EUR"
}
}
In this example, the API populates other transaction fields as expected, but returns a tax amount of zero because tax data isn't available for this region or country.
Updated 3 months ago
