Tax Codes API

Tax codes in Snapbooks represent Norwegian VAT (MVA) rates and categories used in financial transactions. They are essential for accurate tax calculations, reporting, and compliance with Norwegian tax regulations.

Available Endpoints

Method	Endpoint	Description
GET	/tax-codes	List all available tax codes

List Tax Codes

GET /tax-codes

Retrieve a list of all available tax codes, including standard and special Norwegian VAT rates.

Tax Code Properties

Main Attributes

Attribute	Type	Description
id	integer	Unique identifier
code	string	Tax rate identifier (e.g., “MVA25”)
tax_rate	decimal	Percentage rate (e.g., 25.00 for standard Norwegian VAT)
category	string	Tax category: `input` (purchase/acquisition VAT) or `output` (sales VAT). May be `null`
tax_account_id	integer	ID of the output VAT GL account
acquisition_tax_account_id	integer	ID of the input VAT GL account
active_from	date	Validity start date
active_to	date	Validity end date (null if currently active)
compensation	boolean	Compensation scheme indicator
description	string	Language-dependent description (Norwegian/English)

These relationships are not returned by default. Include them by passing the with query parameter (e.g. ?with[]=tax_account&with[]=acquisition_tax_account).

Relationship	Type	Description
tax_account	GeneralLedgerAccount	Output VAT GL account
acquisition_tax_account	GeneralLedgerAccount	Input VAT GL account

Example Request

GET /api/v2/tax-codes?with[]=tax_account&with[]=acquisition_tax_account

Example Response

The endpoint returns a JSON array of tax-code objects (it is not paginated). The tax_account and acquisition_tax_account objects below are only present because they were requested via with.

[
    {
        "id": 1,
        "code": "MVA25",
        "tax_rate": "25.00",
        "category": "output",
        "tax_account_id": 12,
        "acquisition_tax_account_id": 34,
        "active_from": "2023-01-01",
        "active_to": null,
        "compensation": false,
        "description": "Value Added Tax 25%",
        "tax_account": {
            "id": 12,
            "account_code": "2700",
            "description": "Output VAT",
            "mandatory_dimensions": []
        },
        "acquisition_tax_account": {
            "id": 34,
            "account_code": "2710",
            "description": "Input VAT",
            "mandatory_dimensions": []
        }
    }
]

Important Notes

Language Support

Descriptions are available in both Norwegian (description_nob) and English (description_eng)
Language selection based on user locale:
- ‘nb’: Norwegian Bokmål
- ‘en’: English

Technical Details

Include relationships using the with query parameter (supported values: tax_account, acquisition_tax_account)
Dates follow ISO 8601 format (YYYY-MM-DD)
Tax rates are returned as decimal strings for precision

Norwegian VAT Specifics

Standard rate: 25% (most goods and services)
Reduced rates: 15% (food and beverages), 12% (specific services)
Zero rate: 0% (exports and specific goods/services)
Special handling for reverse charge and VAT compensation scheme

For implementation examples and best practices, refer to our Getting Started Guide.