Snapbooks logo Snapbooks Developer

Shareholder Register Report

The Shareholder Register Report API allows you to preview, review, and submit shareholder register reports (aksjonaerregisteroppgaven / RF-1086) to the Norwegian tax authorities (Skatteetaten). The submission process uses Maskinporten authentication and submits both the main form (1086H) and individual shareholder sub-forms (1086U).

Endpoints

Preview Report

GET /api/v2/shareholder-register-report/preview

Generates a preview of the shareholder register report with auto-populated data from the company’s equity transactions. Use this to review data and identify validation issues before submission.

Query Parameters

Parameter Type Required Description
client_account_id integer Yes ID of the client account
reporting_year integer Yes The fiscal year to report for

Response

Returns a preview object containing company information, share capital details, and shareholder data with any validation issues highlighted.

List Submissions

GET /api/v2/shareholder-register-report/submissions

Retrieves a paginated list of shareholder register report submissions.

Query Parameters

Parameter Type Required Description
client_account_id integer Yes ID of the client account
reporting_year integer No Filter by reporting year
order_by string No Sort field
page integer No Page number (default: 1)
page_size integer No Items per page (default: 100)

Response

{
  "data": [
    {
      "id": 1,
      "created_at": "2024-03-15T10:00:00Z",
      "updated_at": "2024-03-15T10:05:00Z",
      "created_by_id": 7,
      "client_account_id": 7,
      "reporting_year": 2023,
      "main_form_reference": "RF-1086H-2023-001",
      "main_form_submitted_at": "2024-03-15T10:01:00Z",
      "sub_forms_count": 3,
      "sub_forms_submitted_at": "2024-03-15T10:03:00Z",
      "confirmation_dialog_id": "dialog-123",
      "confirmation_shipment_id": "shipment-456",
      "confirmed_at": "2024-03-15T10:05:00Z",
      "status": "CONFIRMED",
      "error_message": null
    }
  ],
  "meta": {
    "page": 1,
    "pages": 1,
    "per_page": 100,
    "records": 1
  }
}

Submit Report

POST /api/v2/shareholder-register-report/submissions

Submits a complete shareholder register report to Skatteetaten. The submission process is multi-step:

  1. Creates a draft report
  2. Submits the main form (RF-1086H) with share capital information
  3. Submits a sub-form (RF-1086U) for each shareholder
  4. Confirms the submission

Request Body

Field Type Required Description
client_account_id integer Yes The client account ID
reporting_year integer Yes The fiscal year to report for
contact_business_partner_id integer Yes Business partner with contact email for the submission
share_capital object Yes Share capital details for the company
shareholders array Yes Array of shareholder objects (at least one required)

Example Request

{
  "client_account_id": 7,
  "reporting_year": 2023,
  "contact_business_partner_id": 56,
  "share_capital": {
    "share_capital_amount": 30000,
    "number_of_shares": 1000,
    "par_value": 30
  },
  "shareholders": [
    {
      "business_partner_id": 56,
      "share_class": "COMMON",
      "shares_at_year_start": 500,
      "shares_at_year_end": 600,
      "dividend_amount": 10000
    }
  ]
}

Response

Returns the created submission with status 201 Created.

Attributes

Attribute Type Description
id integer Unique identifier (read-only)
created_at datetime Creation timestamp (read-only)
updated_at datetime Last update timestamp (read-only)
created_by_id integer ID of the user who created the submission (read-only)
client_account_id integer ID of the client account
reporting_year integer The fiscal year reported
main_form_reference string Reference number for the main form
main_form_submitted_at datetime When the main form was submitted (read-only)
sub_forms_count integer Number of shareholder sub-forms submitted (read-only)
sub_forms_submitted_at datetime When sub-forms were submitted (read-only)
confirmation_dialog_id string Dialogporten dialog ID for confirmation (read-only)
confirmation_shipment_id string Dialogporten shipment ID for confirmation (read-only)
confirmed_at datetime When the submission was confirmed (read-only)
status string Submission status (read-only)
error_message string Error details if submission failed (read-only)

Relationships

Relationship Type Description
created_by User The user who created the submission

Authentication Requirements

Submission requires Maskinporten system user authentication. The company must have an accepted system user registration in Altinn. If not configured, the API returns a 400 error with system_user_not_registered.

Error Responses

Status Code Description
400 Invalid request, missing shareholders, or system_user_not_registered
403 Forbidden (no access to client account)