The service does not return any tax information for the following countries and regions. If liability is assigned to one of these, the service will return no information. This is indicated by fields such as "tax_amount": 0.

Afghanistan (AF)
Aland Islands (AX)
Saint Barthelemy (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 (PM)
Pitcairn (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 for Hong Kong

Request

The following request can be sent to return a response for Hong Kong:

{
    "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_1"
            }
        ],
        "sellers": [
            {
                "seller_code": "seller_1",
                "country": "HK",
                "settings": {
                    "countries": {
                        "HK": {
                            "taxation": {
                                "is_seller_registered": true,
                                "physical": {
                                    "is_physical_tax_enabled": true
                                }
                            }
                        }
                    }
                }
            }
        ]
    }
}

Response

This request returns the following response:

{
    "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": "2025-05-19T17: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_1",
                "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_1",
                "country": "HK"
            }
        ],
        "tax_timestamp": "2025-05-19T17:31:29Z",
        "total_amount": 100.00,
        "currency_code": "EUR"
    }
}