Skip to main content
POST
Open a submission
Opens a submission for the sub-report and reporting year you specify. If that pair has already been reported, this opens a correction of it instead. You cannot open a new round while an earlier one for the same pair is still being processed, but different sub-reports run independently.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Open a MAI55 submission for one sub-report and one reporting year

type
enum<string>
required

Which sub-report this submission carries. It fixes which data endpoint accepts pushes under the returned submission id. Only the three MAI55 sub-reports are accepted; any other ReportType is rejected.

Available options:
SIPL,
SLIK,
SKIS
Example:

"SLIK"

reportingYear
integer<int32>
required

Calendar year the data is reported for. If nothing has been reported for this report and year yet a submission is opened; if it has already been reported a correction is opened instead.

Required range: 2016 <= x <= 2100
Example:

2025

webhookUrl
string

Optional webhook URL. When the submission finishes processing it is called with a POST carrying the final status: ACCEPTED or REJECTED.

Maximum string length: 1024
Example:

"https://example.com/mai55/webhook"

Response

Submission or correction opened

Handle of an opened submission

submissionId
string
required

Submission id, scopes all subsequent calls

type
enum<string>
required

Which sub-report this submission carries

Available options:
SIPL,
SLIK,
SKIS
Example:

"SLIK"

kind
enum<string>
required

Whether the reporting year was opened as a submission or as a correction of it

Available options:
SUBMISSION,
CORRECTION
Last modified on September 1, 2026