Skip to main content
POST
Open a submission
Opens a submission for the reporting year you specify. If that year has already been reported, this opens a correction of it instead. You cannot open a new submission while an earlier one for the same year is still being processed.

Authorizations

Authorization
string
header
required

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

Body

application/json

Open a CRS submission for a reporting year

reportingYear
integer<int32>
required

Calendar year the accounts are reported for. If nothing has been reported for this year yet a submission is opened; if the year 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 (the tax authority's validation result for the submission).

Maximum string length: 1024
Example:

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

Response

Submission or correction opened

Handle of an opened submission

submissionId
string
required

Submission id, scopes all subsequent calls

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 August 6, 2026