Calendar Events

The calendar resource represents calendar events in Snapbooks. Calendar events are mostly accounting-related events, such as the due date of government reporting (VAT, withholding tax, tax return, shareholder register report, annual accounts submission).

List calendar events

GET /api/v2/calendar

Retrieves a list of calendar events for a date range. When client_account_id is provided, events are filtered to those that apply to the client account’s organization properties (e.g. VAT-liable, has payroll, has shareholders).

Query Parameters

Name	Type	Required	Description
`client_account_id`	integer	No	The client account ID. When provided, events are filtered by the client account’s organization properties. Without it, all events in the date range are returned.
`from_date`	string	No	The start date to fetch events from in YYYY-MM-DD format. Defaults to today.
`to_date`	string	No	The end date to fetch events until in YYYY-MM-DD format. Defaults to one year after `from_date`.
`with`	string	No	Comma-separated list of optional fields to include. Supported: `event_data` (only effective when `client_account_id` is also provided).

Response

A successful response returns a JSON array of calendar events, sorted by due date ascending:

[
  {
    "event_type": "WITHHOLDING_TAX_AND_EMPLOYER_CONTRIBUTION",
    "if": ["HAS_PAYROLL"],
    "due_date": "2026-01-15",
    "reporting_period": {
      "start_date": "2025-11-01",
      "end_date": "2025-12-31"
    }
  },
  {
    "event_type": "VAT_REPORTING",
    "if": ["IS_VAT_LIABLE", "VAT_REPORTING_BIMONTHLY"],
    "due_date": "2026-02-10",
    "reporting_period": {
      "start_date": "2025-11-01",
      "end_date": "2025-12-31"
    }
  }
]

When with=event_data is requested together with client_account_id, each event may include an additional event_data object whose shape depends on the event type. For VAT_REPORTING events, event_data contains the VAT period status (see VAT Returns). For other event types, event_data is currently an empty object.

Response Fields

Field	Type	Description
`event_type`	string	The type of calendar event. See the table below.
`if`	array	Organization properties that must all be present on the client account for the event to apply.
`ifnot`	array	Organization properties that must all be absent on the client account for the event to apply. Only present when applicable.
`due_date`	string	The date when the event is due in YYYY-MM-DD format.
`reporting_period`	object	The period this event covers.
`reporting_period.start_date`	string	Start date of the reporting period in YYYY-MM-DD format.
`reporting_period.end_date`	string	End date of the reporting period in YYYY-MM-DD format.
`event_data`	object	Optional, included only when `with=event_data` is requested. Shape varies by event type.

Event Types

Event type	Description
`WITHHOLDING_TAX_AND_EMPLOYER_CONTRIBUTION`	Bi-monthly withholding tax and employer contribution deadline. Applies when the client has payroll.
`VAT_REPORTING`	MVA-melding submission deadline. Bi-monthly, annual, or annual primary-industry depending on the client’s reporting frequency.
`TAX_RETURN`	Annual corporate tax return deadline.
`SHAREHOLDER_REGISTER_REPORT`	Annual RF-1086 aksjonærregisteroppgave deadline. Applies when the client has shareholders.
`ANNUAL_ACCOUNTS_SUBMISSION`	Annual accounts submission deadline. Applies when the client is accounting-obligated.

Organization Property Flags

The if and ifnot arrays reference organization-level flags on the client account. Common values:

Flag	Description
`HAS_PAYROLL`	The client account runs payroll.
`IS_VAT_LIABLE`	The client account is registered for VAT.
`VAT_REPORTING_BIMONTHLY`	The client account reports VAT every two months.
`VAT_REPORTING_ANNUAL`	The client account reports VAT annually.
`PRIMARY_INDUSTRY`	The client account is in a primary industry (different annual VAT deadline).
`HAS_SHAREHOLDERS`	The client account has shareholders.
`ACCOUNTING_OBLIGATED`	The client account is required to submit annual accounts.