Get tax rates

cURL

curl --request GET \
  --url https://api.maesn.dev/accounting/taxRates \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'

import requests

url = "https://api.maesn.dev/accounting/taxRates"

headers = {
    "X-API-KEY": "<x-api-key>",
    "X-ACCOUNT-KEY": "<x-account-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-API-KEY': '<x-api-key>', 'X-ACCOUNT-KEY': '<x-account-key>'}
};

fetch('https://api.maesn.dev/accounting/taxRates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.maesn.dev/accounting/taxRates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-ACCOUNT-KEY: <x-account-key>",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.maesn.dev/accounting/taxRates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<x-api-key>")
	req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.maesn.dev/accounting/taxRates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'

response = http.request(request)
puts response.read_body

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": [
    {
      "id": "b0450a0a-4164-4b5a-b006-1f3e835c32ff",
      "code": "02",
      "createdDate": "2021-01-01T00:00:00Z",
      "description": "BTW hoog tarief, exclusief",
      "name": "21 PERCENT",
      "percentage": 21,
      "updatedDate": "2021-01-01T00:00:00Z"
    }
  ]
}

GET

accounting

taxRates

cURL

curl --request GET \
  --url https://api.maesn.dev/accounting/taxRates \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'

import requests

url = "https://api.maesn.dev/accounting/taxRates"

headers = {
    "X-API-KEY": "<x-api-key>",
    "X-ACCOUNT-KEY": "<x-account-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-API-KEY': '<x-api-key>', 'X-ACCOUNT-KEY': '<x-account-key>'}
};

fetch('https://api.maesn.dev/accounting/taxRates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.maesn.dev/accounting/taxRates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-ACCOUNT-KEY: <x-account-key>",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.maesn.dev/accounting/taxRates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<x-api-key>")
	req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.maesn.dev/accounting/taxRates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'

response = http.request(request)
puts response.read_body

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": [
    {
      "id": "b0450a0a-4164-4b5a-b006-1f3e835c32ff",
      "code": "02",
      "createdDate": "2021-01-01T00:00:00Z",
      "description": "BTW hoog tarief, exclusief",
      "name": "21 PERCENT",
      "percentage": 21,
      "updatedDate": "2021-01-01T00:00:00Z"
    }
  ]
}

Field support per integration

bexio

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

boolean

Supported response fields:

string

number

Business Central

If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName and companyId are correctly populated. You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

string

Show object

string

Filter by last modified date.
Example: lastModifiedAt=2021-01-01T00:00:00Z

boolean

Supported response fields:

string

DATEV Unternehmen Online

If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is accurately populated with the appropriate company ID. You can obtain this value by using the GET Companies endpoint available under the Authentication section.

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

Supported response fields:

string

number

enum

Available options: INVOICE, BILL, CASH

DATEV Rechnungswesen

Query parameters:

number

Supported response fields:

string

number

enum

Available options: INVOICE, BILL, CASH

Dinero

If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

boolean

Supported response fields:

string

number

Exact Online

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

string

Show object

string

Filter by last modified date.
Example: lastModifiedAt=2021-01-01T00:00:00Z

boolean

Supported response fields:

string

number

string

Available values: INCLUSIVE, EXCLUSIVE, ZERO_TAX, NO_TAXIndicates how the tax amount should be calculated in relation to an invoice or bill amount.

string

enum

Available options: INVOICE, BILL, ALL

Moneybird

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

string

Show object

string

Filter by last modified date.
Example: lastModifiedAt=2021-01-01T00:00:00Z

boolean

Supported response fields:

string

number

string

enum

Available options: INVOICE, BILL,JOURNAL_ENTRY, ALL

Procountor

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

boolean

Supported response fields:

string

Only one of the code and percentage fields will be provided for each entry.

string

number

Only one of the code and percentage fields will be provided for each entry.

enum

Available options: INVOICE, BILL, ALL

QuickBooks

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

string

Show object

string

Filter by last modified date.
Example: lastModifiedAt=2021-01-01T00:00:00Z

boolean

Supported response fields:

string

number

string

enum

Available options: INVOICE, BILL

Snelstart

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

string

Show object

boolean

Filter by active state.
Example: isActive=true

boolean

Supported response fields:

string

number

Twinfield

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

boolean

Supported response fields:

string

number

string

enum

Available options: INVOICE, BILL

Xero

Query parameters:

enum

Available options: 5, 10, 20, 50, 100

number

boolean

Supported response fields:

string

number

Headers

X-API-KEY

string

required

API key

Example:

"example value"

X-ACCOUNT-KEY

string

required

Account key

Example:

"example value"

Query Parameters

page

number

limit

enum<number>

Available options:

5,

10,

20,

50,

100

companyId

string

environmentName

string

lastModifiedAt

number

isActive

boolean

rawData

boolean

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Knowledgebase

Get tax rates

Field support per integration

Headers

Query Parameters

Response

​Field support per integration

Headers

Query Parameters

Response

Field support per integration