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 (e.g., standard, reduced, zero) |
| tax_account_id | integer | Output VAT account ID |
| acquisition_tax_account_id | integer | Input VAT account ID |
| 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) |
Related Resources
| Relationship | Type | Description |
|---|---|---|
| tax_account | GeneralLedgerAccount | Output VAT GL account |
| acquisition_tax_account | GeneralLedgerAccount | Input VAT GL account |
Example Response
{
"id": 1,
"code": "VAT25",
"tax_rate": "25.00",
"category": "standard",
"tax_account_id": 2400,
"acquisition_tax_account_id": 2710,
"active_from": "2023-01-01",
"active_to": null,
"compensation": false,
"description": "Value Added Tax 25%",
"tax_account": {
"id": 2400,
"account_code": "2400",
"description": "Output VAT",
"mandatory_dimensions": []
},
"acquisition_tax_account": {
"id": 2710,
"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_relationsparameter - 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.