List tax rates

GET/public/v1/erp/tax_rates

Bearer token

Retrieve the tax rates available for calculating VAT on Qashio spend.

Returns a paginated list of tax rates synced from your accounting system, newest first. Transactions and line items reference these records so VAT is applied using the same rate definitions your ledger uses.

Query parameters

pageinteger: Example 1
page_sizeinteger: Example 20
remote_idstring
remote_namestring
statusstring: draftactiveinactive
is_deletedstring: truefalse
created_at_fromstring
created_at_tostring
updated_at_fromstring
updated_at_tostring

Response

Array of tax rates, plus pagination.

Field	Type	Description
`id`	string	Qashio identifier (UUID)
`remote_id`	string	Identifier in your accounting system
`remote_name`	string	Tax rate name, e.g. `VAT 5%`
`tax_rate_code`	string	Code used in your accounting system
`total_tax_rate`	number	Effective percentage
`country_code`	string	Country the rate applies to
`status`	string	`draft`, `active` or `inactive`
`is_deleted`	boolean	Marked deleted upstream
`created_at` / `updated_at`	string	ISO 8601 timestamps

Response schema from the OpenAPI document

Field	Type	Description
`status_code`	integer
`success`	boolean
`data`	object[]
`id`	string
`remote_name`	string
`remote_id`	string
`tax_rate_code`	string
`total_tax_rate`	integer
`status`	string
`country_code`	string
`is_deleted`	boolean
`updated_at`	string
`created_at`	string
`meta`	object
`request_id`	string
`timestamp`	string
`pagination`	object
`page`	integer
`page_size`	integer
`total_pages`	integer
`total_records`	integer
`has_next`	boolean
`has_previous`	boolean

Errors

400, 401, 403.

401Unauthorized - missing or invalid Bearer token

Every error carries an errors[] array and a meta.request_id. See Errors for the full envelope.

GET/public/v1/erp/tax_rates

curl -X GET 'https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <access_token>'

const accessToken = process.env.QASHIO_ACCESS_TOKEN;

const response = await fetch('https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20', {
  method: 'GET',
  headers: {
    Accept: 'application/json',
    Authorization: `Bearer ${accessToken}`,
  },
});

if (!response.ok) {
  throw new Error(`Qashio API ${response.status}: ${await response.text()}`);
}

const { data, meta } = await response.json();
console.log(meta.request_id, data);

import https from 'node:https';

const url = new URL('https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20');

const payload = await new Promise((resolve, reject) => {
  const req = https.request(
    url,
    {
      method: 'GET',
      headers: {
      Accept: 'application/json',
      Authorization: `Bearer ${process.env.QASHIO_ACCESS_TOKEN}`,
      },
    },
    (res) => {
      let raw = '';
      res.on('data', (chunk) => (raw += chunk));
      res.on('end', () => resolve(JSON.parse(raw)));
    },
  );
  req.on('error', reject);
  req.end();
});

console.log(payload.data);

import os
import requests

url = "https://api.qashio.com/public/v1/erp/tax_rates"
headers = {
    "Accept": "application/json",
    "Authorization": f"Bearer {os.environ['QASHIO_ACCESS_TOKEN']}",
}

params = {
    "page": 1,
    "page_size": 20,
}

response = requests.get(url, headers=headers, params=params, timeout=30)
response.raise_for_status()

body = response.json()
print(body["meta"]["request_id"], body["data"])

<?php

$ch = curl_init('https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20');

curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST  => 'GET',
  CURLOPT_HTTPHEADER     => [
      'Accept: application/json',
      'Authorization: Bearer ' . getenv('QASHIO_ACCESS_TOKEN'),
  ],
]);

$response = curl_exec($ch);
curl_close($ch);

$body = json_decode($response, true);
print_r($body['data']);

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20", nil)
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer "+os.Getenv("QASHIO_ACCESS_TOKEN"))

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	var out map[string]any
	json.NewDecoder(res.Body).Decode(&out)
	fmt.Println(out["data"])
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20')
request = Net::HTTP::Get.new(uri)
request['Accept'] = 'application/json'
request['Authorization'] = "Bearer #{ENV.fetch('QASHIO_ACCESS_TOKEN')}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

body = JSON.parse(response.body)
puts body['data']

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class QashioExample {
  public static void main(String[] args) throws Exception {
    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20"))
        .header("Accept", "application/json")
        .header("Authorization", "Bearer " + System.getenv("QASHIO_ACCESS_TOKEN"))
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());

    System.out.println(response.body());
  }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;

var client = new HttpClient();

var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", $"Bearer {Environment.GetEnvironmentVariable("QASHIO_ACCESS_TOKEN")}");

var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();

Console.WriteLine(await response.Content.ReadAsStringAsync());

import Foundation

var request = URLRequest(url: URL(string: "https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20")!)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
let token = ProcessInfo.processInfo.environment["QASHIO_ACCESS_TOKEN"]!
request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")

let (data, _) = try await URLSession.shared.data(for: request)
print(String(data: data, encoding: .utf8)!)

Response

{
  "status_code": 200,
  "success": true,
  "data": [
    {
      "id": "2d3117fb-bb15-4260-8064-261984d34086",
      "remote_name": "Tax Rate - 1",
      "remote_id": "295",
      "tax_rate_code": "EXEMPT",
      "total_tax_rate": 0,
      "status": "inactive",
      "country_code": "SAU",
      "is_deleted": false,
      "updated_at": "2026-07-16T00:35:46.603Z",
      "created_at": "2026-07-16T00:35:46.603Z"
    }
  ],
  "meta": {
    "request_id": "3adb2d16090c7b3bdbde3b326a814b30",
    "timestamp": "2026-09-09T10:07:52.143Z"
  },
  "pagination": {
    "page": 1,
    "page_size": 20,
    "total_pages": 1,
    "total_records": 7,
    "has_next": false,
    "has_previous": false
  }
}

{
  "status_code": 401,
  "success": false,
  "message": "Missing Bearer token",
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing Bearer token"
  },
  "errors": [
    {
      "code": "UNAUTHORIZED",
      "message": "Missing Bearer token",
      "field": "authorization"
    }
  ],
  "meta": {
    "request_id": "3adb2d16090c7b3bdbde3b326a814b30",
    "timestamp": "2026-09-09T10:07:52.143Z"
  }
}