Skip to main content
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>'
{
  "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,
      "type": "INCLUSIVE",
      "updatedDate": "2021-01-01T00:00:00Z",
      "usage": "INVOICE"
    }
  ]
}

​
Field support per integration

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.
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
code
string
​
createdDate
string
​
description
string
​
percentage
number
​
type
string
Available values: INCLUSIVE, EXCLUSIVE, ZERO_TAX, NO_TAXIndicates how the tax amount should be calculated in relation to an invoice or bill amount.
​
updatedDate
string
​
usage
enum
Available options: INVOICE, BILL, ALL
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.
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
code
string
​
createdDate
string
​
name
string
​
percentage
number
​
updatedDate
string
​
usage
enum
Available options: INVOICE, BILL,JOURNAL_ENTRY, ALL
Supported filters: noneSupport pagination: trueSupport rawData: true
Supported Response Fields:
​
code
string
​
name
string
​
percentage
number
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.
Supported filters: noneSupport pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
code
string
​
createdDate
string
​
description
string
​
name
string
​
percentage
number
​
updatedDate
string
​
usage
enum
Available options: INVOICE, BILL
Supported filters: noneSupport pagination: trueSupport rawData: true
Supported Response Fields:
​
name
string
​
percentage
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
​
rawData
boolean

Response

200 - application/json
​
meta
object
​
data
object[]