Skip to main content
POST
Create a submission
The returned submissionId scopes every subsequent payee, payment, and submit call. Opening a submission for a period and country that has already been reported starts a correction round.

Authorizations

Authorization
string
header
required

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

Body

application/json

Create a CESOP submission for a reporting period and country

year
integer<int32>
required

Reporting year (CESOP reporting started in 2024)

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

2024

quarter
integer<int32>
required

Reporting quarter 1-4

Required range: 1 <= x <= 4
Example:

1

countryCode
string
required

Reportable country: an EU Member State, given as an ISO 3166-1 alpha-2 code

Minimum string length: 1
Example:

"DE"

webhookUrl
string

Optional webhook URL. When the submission finishes processing it is called with a POST carrying the final status: ACCEPTED or REJECTED (the CESOP validation result for the submission).

Maximum string length: 1024
Example:

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

Response

201 - application/json

Submission created

Handle of a created submission

submissionId
string
required

Submission id, scopes all subsequent calls

Last modified on July 22, 2026