Update tax settings
Changes the tax settings. Each list you send replaces the saved list. On accounts where Comecero is the seller, rules is ignored because Comecero handles the tax. Settings are kept per mode: a test token works on the test settings, a live token on the live ones. Secret and trusted tokens may call it when their permissions include settings_tax. Limited tokens may not.
AuthorizationBearer <token>A secret, trusted or limited token. See Authentication.
show?stringComma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.
hide?stringComma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.
formatted?booleanWhen true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.
falseapplication/json- body
The tax fields to change. Send only the fields you want to change. Each list you send replaces the saved list; an empty list or null clears it.
1 <= propertiestax_inclusive_countries?array<string>|Two-letter ISO codes, EU or *.
gross_discount_countries?array<string>|Two-letter ISO codes, EU or *.
rules?array<>|The full list of tax rules. Ignored on accounts where Comecero is the seller, since Comecero handles the tax.
The tax settings, after the change.
application/json- response
Tax settings of the account in the current mode: where prices include tax, where discounts apply before tax, and your own tax rules.
object?"settings_tax"The object type. Always settings_tax.
"settings_tax"url?stringThe URL of this object.
uriaccount_id?stringThe ID of the account the settings belong to.
test?booleanTrue for the test mode settings, false for live.
date_modified?stringWhen the settings were last changed.
date-timetax_inclusive_countries?array<string>Countries where your prices already include tax. Two-letter ISO codes, EU for every EU country, or * for every country.
gross_discount_countries?array<string>Countries where discounts are taken off the price including tax. Two-letter ISO codes, EU or *.
rules?array<>Your own tax rules. Only accounts that sell as themselves (not through Comecero as the seller) use them.
formatted?Display text for the dates. Returned only when formatted=true.
curl -X POST 'https://api.comecero.com/api/v1/settings/tax' \ -H 'Content-Type: application/json' \ -d '{ "tax_inclusive_countries": [ "EU", "GB" ]}'{ "object": "settings_tax", "url": "https://api.comecero.com/api/v1/settings/tax", "account_id": "AB1234", "test": true, "date_modified": "2026-10-02T14:21:07Z", "tax_inclusive_countries": [ "EU" ], "gross_discount_countries": [], "rules": [ { "country": "US", "state_prov": "WA", "location_postal_code": null, "rate": null, "tax_code": null }, { "country": "AU", "state_prov": null, "location_postal_code": null, "rate": 0.1, "tax_code": null } ]}Get tax settings GET
Returns the tax inclusive countries, gross discount countries and your own tax rules. Settings are kept per mode: a test token works on the test settings, a live token on the live ones. Secret and trusted tokens may call it when their permissions include `settings_tax`. Limited tokens may not.
Get technical settings GET
Returns the time zone, shop host names, app alias redirects, the signing key for webhooks, OAuth redirect addresses and CORS origins. The response holds your signing key: call it from your server only. Settings are kept per mode: a test token works on the test settings, a live token on the live ones. Secret and trusted tokens may call it when their permissions include `settings_technical`. Limited tokens may not.