Accounting API Taxes

List all tax rules

GET https://api.tamio.com/v2/taxes/list

Returns a paginated list of tax rules. Results can be sorted by rate, country, or label.

Query Parameters

page integer*

Page number for pagination.

per_page integer*

Number of tax rules per page.

order string

Sort direction.

ascdesc

sort_by string

Field to sort by.

ratecountrylabel

Responses

200 Paginated list of tax rules

Paginated list of tax rules

status integer

total_results integer

Total number of tax rules matching the query.

taxes array of Tax

id string

Unique identifier of the tax rule.

object string

Object type identifier.

rate number

Tax rate as a decimal (e.g. 0.20 for 20%).

amount number

Fixed tax amount as a decimal. 0 when a percentage rate is used.

label string

Human-readable display name.

active boolean

Whether the tax rule is currently active.

country string

ISO country code where the tax applies.

type string

Tax rule type.

product_taxshipping_tax

applies_to string

Application scope (e.g. all_products, selected_products, selected_categories, all_shippings, selected_shippings).

postcodes array of string

Postal code restrictions. Null when the tax applies to all postcodes.

states array of string

State/province restrictions. Null when the tax applies to all states.

payments array of string

Payment method restrictions. Null when the tax applies to all payment methods.

categories object

Category selections. Only present for product taxes with selected_categories scope, null otherwise.

physical array of string

Physical product categories.

digital array of string

Digital product categories.

services array of string

Service categories.

billing_plans array of string

Billing plan categories.

products array of string

Product UUIDs. Only present for product taxes with selected_products scope, null otherwise.

401 Missing or invalid API key

Retrieve a tax rule

/taxes/list

1 const response = await fetch("https://api.tamio.com/v2/taxes/list", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/taxes/list")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "total_results": 8,
  "taxes": [
    {
      "id": "aaa14567-e89b-12d3-a456-426614174000",
      "object": "tax",
      "rate": 0.2,
      "amount": 0,
      "label": "EU VAT 20%",
      "active": true,
      "country": "GB",
      "type": "product_tax",
      "applies_to": "all_products",
      "postcodes": null,
      "states": null,
      "payments": null,
      "categories": null,
      "products": null
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/taxes/list", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/taxes/list")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body