> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maesn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get tax rates

## Field support per integration

<AccordionGroup>
  <Accordion title="bexio" icon="https://mintcdn.com/maesn/51AaCYhZi3VILsjj/logo/bexio.svg?fit=max&auto=format&n=51AaCYhZi3VILsjj&q=85&s=1725cd998107a00ea8f7f9a83c250e29" width="24" height="24" data-path="logo/bexio.svg">
    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="id" type="string" />

    <ResponseField name="code" type="string" />

    <ResponseField name="description" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number" />
  </Accordion>

  <Accordion title="Business Central" icon="https://mintcdn.com/maesn/51AaCYhZi3VILsjj/logo/businesscentral.svg?fit=max&auto=format&n=51AaCYhZi3VILsjj&q=85&s=9cdc50aa9f467133e9e9372eab83f38b" width="24" height="24" data-path="logo/businesscentral.svg">
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#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.
    </Note>

    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="filter" type="string">
      <Expandable title="object">
        <ResponseField name="lastModifiedAt" type="string">
          Filter by last modified date.<br />
          Example: `lastModifiedAt=2021-01-01T00:00:00Z`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="id" type="string" />

    <ResponseField name="code" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="updatedDate" type="string" />
  </Accordion>

  <Accordion title="DATEV Unternehmen Online" icon="https://mintcdn.com/maesn/NQwZPkomn6wLid0x/logo/datev.svg?fit=max&auto=format&n=NQwZPkomn6wLid0x&q=85&s=5589154dcfa064e1d967a067e488896a" width="24" height="24" data-path="logo/datev.svg">
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#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.
    </Note>

    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    Supported response fields:

    <ResponseField name="code" type="string" />

    <ResponseField name="description" type="string" />

    <ResponseField name="percentage" type="number" />

    <ResponseField name="usage" type="enum">
      Available options: `INVOICE`, `BILL`, `CASH`
    </ResponseField>
  </Accordion>

  <Accordion title="DATEV Rechnungswesen" icon="https://mintcdn.com/maesn/NQwZPkomn6wLid0x/logo/datev.svg?fit=max&auto=format&n=NQwZPkomn6wLid0x&q=85&s=5589154dcfa064e1d967a067e488896a" width="24" height="24" data-path="logo/datev.svg">
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#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.
    </Note>

    Query parameters:

    <ResponseField name="page" type="number" />

    Supported response fields:

    <ResponseField name="code" type="string" />

    <ResponseField name="description" type="string" />

    <ResponseField name="percentage" type="number" />

    <ResponseField name="usage" type="enum">
      Available options: `INVOICE`, `BILL`, `CASH`
    </ResponseField>
  </Accordion>

  <Accordion title="Dinero" icon="https://mintcdn.com/maesn/kIVKlwzahCAaENRK/logo/dinero.svg?fit=max&auto=format&n=kIVKlwzahCAaENRK&q=85&s=5c26225da75d99a6f6e099c50483eaa3" width="200" height="200" data-path="logo/dinero.svg">
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#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.
    </Note>

    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="rawData" type="boolean" />

    <br />

    Supported response fields:

    <ResponseField name="id" type="string" />

    <ResponseField name="code" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number" />
  </Accordion>

  <Accordion title="Exact Online" icon="https://mintcdn.com/maesn/gCd41Ws3USFubam4/logo/exact.svg?fit=max&auto=format&n=gCd41Ws3USFubam4&q=85&s=afa1af7a261b22f843ac73ee60896ede" width="24" height="24" data-path="logo/exact.svg">
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#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.
    </Note>

    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="filter" type="string">
      <Expandable title="object">
        <ResponseField name="lastModifiedAt" type="string">
          Filter by last modified date.<br />
          Example: `lastModifiedAt=2021-01-01T00:00:00Z`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="id" type="string" />

    <ResponseField name="code" type="string" />

    <ResponseField name="createdDate" type="string" />

    <ResponseField name="description" type="string" />

    <ResponseField name="percentage" type="number" />

    <ResponseField name="type" type="string">
      Available values: `INCLUSIVE`, `EXCLUSIVE`, `ZERO_TAX`, `NO_TAX`

      Indicates how the tax amount should be calculated in relation to an invoice or bill amount.
    </ResponseField>

    <ResponseField name="updatedDate" type="string" />

    <ResponseField name="usage" type="enum">
      Available options: `INVOICE`, `BILL`, `ALL`
    </ResponseField>
  </Accordion>

  <Accordion title="Moneybird" icon="https://mintcdn.com/maesn/51AaCYhZi3VILsjj/logo/moneybird.svg?fit=max&auto=format&n=51AaCYhZi3VILsjj&q=85&s=4cf7d956fec579e320389df5b2a6c828" width="24" height="24" data-path="logo/moneybird.svg">
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#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.
    </Note>

    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="filter" type="string">
      <Expandable title="object">
        <ResponseField name="lastModifiedAt" type="string">
          Filter by last modified date.<br />
          Example: `lastModifiedAt=2021-01-01T00:00:00Z`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="id" type="string" />

    <ResponseField name="code" type="string" />

    <ResponseField name="createdDate" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number" />

    <ResponseField name="updatedDate" type="string" />

    <ResponseField name="usage" type="enum">
      Available options: `INVOICE`, `BILL`,`JOURNAL_ENTRY`, `ALL`
    </ResponseField>
  </Accordion>

  <Accordion title="Procountor" icon="https://mintcdn.com/maesn/HTRn5skspTPqFN8X/logo/procountor.svg?fit=max&auto=format&n=HTRn5skspTPqFN8X&q=85&s=2399887f31b698590774969aa7581f9a" width="720" height="410" data-path="logo/procountor.svg">
    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="code" type="string">
      Only one of the `code` and `percentage` fields will be provided for each entry.
    </ResponseField>

    <ResponseField name="description" type="string" />

    <ResponseField name="percentage" type="number">
      Only one of the `code` and `percentage` fields will be provided for each entry.
    </ResponseField>

    <ResponseField name="usage" type="enum">
      Available options: `INVOICE`, `BILL`, `ALL`
    </ResponseField>
  </Accordion>

  <Accordion title="QuickBooks" icon="https://mintcdn.com/maesn/51AaCYhZi3VILsjj/logo/quickbooks.svg?fit=max&auto=format&n=51AaCYhZi3VILsjj&q=85&s=7733377805a0f59c4cdada5817544447" width="24" height="24" data-path="logo/quickbooks.svg">
    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="filter" type="string">
      <Expandable title="object">
        <ResponseField name="lastModifiedAt" type="string">
          Filter by last modified date.<br />
          Example: `lastModifiedAt=2021-01-01T00:00:00Z`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="code" type="string" />

    <ResponseField name="createdDate" type="string" />

    <ResponseField name="description" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number" />

    <ResponseField name="updatedDate" type="string" />

    <ResponseField name="usage" type="enum">
      Available options: `INVOICE`, `BILL`
    </ResponseField>
  </Accordion>

  <Accordion title="Snelstart" icon="https://mintcdn.com/maesn/51AaCYhZi3VILsjj/logo/snelstart.svg?fit=max&auto=format&n=51AaCYhZi3VILsjj&q=85&s=a18e70fedba8b4166ced134d0ad1b8e3" width="24" height="24" data-path="logo/snelstart.svg">
    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="filter" type="string">
      <Expandable title="object">
        <ResponseField name="isActive" type="boolean">
          Filter by active state.<br />
          Example: `isActive=true`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="code" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number" />
  </Accordion>

  <Accordion title="Tripletex" icon="https://mintcdn.com/maesn/PAQw41f6NgOfTYHL/logo/tripletex.svg?fit=max&auto=format&n=PAQw41f6NgOfTYHL&q=85&s=d6386c1bc69580729a658d7c4f48fd45" width="26" height="38" data-path="logo/tripletex.svg">
    <Note>
      Use the [Interactive Authentication Flow](/authentication#interactive-authentication-flow)  to connect Tripletex. It works for both token types: with an accountant token, the user picks the client company from a list;
      with a regular single-company token, the user's own company is selected automatically and no list is shown. You can also set companyId directly if you already know the client company id (accountant tokens only).
    </Note>

    <Note>
      Tax rates are the Norwegian VAT codes (`vatType`) active for the company. For accountant (multi-company) tokens, populate `companyId` — or use the [Interactive Authentication Flow](/authentication#interactive-authentication-flow) — to target a client company; a regular single-company token can omit it.
    </Note>

    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="id" type="string" />

    <ResponseField name="code" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number">
      Normalised VAT rate. The sign is dropped (Tripletex returns reverse-charge and import codes as negative), and direct-posting codes — which Tripletex reports as `100`, a basis rather than a rate — are returned as `null`. Use `rawData=true` for the original Tripletex values.
    </ResponseField>
  </Accordion>

  <Accordion title="Twinfield" icon="https://mintcdn.com/maesn/51AaCYhZi3VILsjj/logo/twinfield.svg?fit=max&auto=format&n=51AaCYhZi3VILsjj&q=85&s=aacf76ab75d30aabd615bc761d08f405" width="24" height="24" data-path="logo/twinfield.svg">
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#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.
    </Note>

    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="id" type="string" />

    <ResponseField name="code" type="string" />

    <ResponseField name="createdDate" type="string" />

    <ResponseField name="description" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number" />

    <ResponseField name="updatedDate" type="string" />

    <ResponseField name="usage" type="enum">
      Available options: `INVOICE`, `BILL`
    </ResponseField>
  </Accordion>

  <Accordion title="Visma e-conomic" icon="https://mintcdn.com/maesn/51AaCYhZi3VILsjj/logo/vismaeconomic.svg?fit=max&auto=format&n=51AaCYhZi3VILsjj&q=85&s=4b629e8bc1bfd12c3bedaaaf9cc03ef3" width="20" height="24" data-path="logo/vismaeconomic.svg">
    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="id" type="string" />

    <ResponseField name="code" type="string" />

    <ResponseField name="description" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number" />
  </Accordion>

  <Accordion title="Xero" icon="https://mintcdn.com/maesn/51AaCYhZi3VILsjj/logo/xero.svg?fit=max&auto=format&n=51AaCYhZi3VILsjj&q=85&s=4496b21aab750469b3d5e96a1588d9f0" width="45" height="46" data-path="logo/xero.svg">
    Query parameters:

    <ResponseField name="limit" type="enum">
      Available options: `5`, `10`, `20`, `50`, `100`
    </ResponseField>

    <ResponseField name="page" type="number" />

    <ResponseField name="rawData" type="boolean" />

    Supported response fields:

    <ResponseField name="name" type="string" />

    <ResponseField name="percentage" type="number" />
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml get /accounting/taxRates
openapi: 3.0.0
info:
  title: Maesn unified API
  description: The Maesn unified API description
  version: '1.0'
  contact: {}
servers:
  - url: https://api.maesn.dev
security: []
tags:
  - name: maesn
    description: ''
paths:
  /accounting/taxRates:
    get:
      tags:
        - accounting
      operationId: getTaxRates
      parameters:
        - name: page
          required: false
          in: query
          schema:
            type: number
        - name: limit
          required: false
          in: query
          schema:
            enum:
              - 5
              - 10
              - 20
              - 50
              - 100
            type: number
        - name: companyId
          required: false
          in: query
          schema:
            type: string
        - name: environmentName
          in: query
          schema:
            type: string
          required: false
        - name: lastModifiedAt
          required: false
          in: query
          schema:
            type: number
        - name: isActive
          required: false
          in: query
          schema:
            type: boolean
        - name: rawData
          required: false
          in: query
          schema:
            type: boolean
        - name: X-API-KEY
          description: API key
          in: header
          schema:
            type: string
            example: example value
          required: true
        - name: X-ACCOUNT-KEY
          description: Account key
          in: header
          schema:
            type: string
            example: example value
          required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BaseResponseDto'
                  - properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/TaxRateResponseDto'
components:
  schemas:
    BaseResponseDto:
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/MetaResponse'
        data:
          oneOf:
            - type: object
            - type: array
    TaxRateResponseDto:
      type: object
      properties:
        id:
          type: string
          example: b0450a0a-4164-4b5a-b006-1f3e835c32ff
        code:
          type: string
          example: '02'
        createdDate:
          type: string
          example: '2021-01-01T00:00:00Z'
        description:
          type: string
          example: BTW hoog tarief, exclusief
        name:
          type: string
          example: 21 PERCENT
        percentage:
          type: number
          example: 21
        type:
          type: string
          enum:
            - INCLUSIVE
            - EXCLUSIVE
            - ZERO_TAX
            - NO_TAX
        updatedDate:
          type: string
          example: '2021-01-01T00:00:00Z'
        usage:
          type: string
          enum:
            - INVOICE
            - BILL
            - JOURNAL_ENTRY
            - ALL
    MetaResponse:
      type: object
      properties:
        warnings:
          type: array
          items:
            type: string
            example: Field not used by target system
        pagination:
          $ref: '#/components/schemas/PaginationResponse'
    PaginationResponse:
      type: object
      properties:
        total:
          type: number
          example: 125
        perPage:
          type: number
          example: 50
        currentPage:
          type: number
          example: 1
        totalPages:
          type: number
          example: 3

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.