1. Overview
The clearing day calendar contains scheduling information for the electronic payment services provided by SIX Interbank Clearing Ltd. The information in the clearing day calendar includes events scheduled for future dates.
These scheduled events (e.g. a clearing stop 1 at 15:00 on 2nd May 2025) are established in November for the following year. Once the events for the next year have been scheduled, they are avaiable via the API. The API only includes forthcoming dates, which means that its contents will diminish as the year progresses. Therefore, the number of days listed may vary.
Given that the information regarding these scheduled events may change (e.g. an extension of a scheduled downtime), an update will be issued daily at approximately 16:30 CET.
Any rescheduling to take place at short notice (e.g. the shift of clearing stop 1 on the actual clearing day) is not communicated in the clearing day calendar but through ISO 20022 messages sent directly from the respective SIC service.
Disclaimer
SIX assumes no responsibility for the completeness of the information provided in this document, nor for any damages from actions taken based on this information. SIX reserves the express right to change or delete this information at any time.
1.1. Version information
Version : 1.0 (generated 2024-03-27T17:02:01Z)
1.2. Contact information
Contact : SIX Interbank Clearing
Contact Email : operations.sic@six-group.com
1.3. URI scheme
Host : api.six-group.com
BasePath : /api/epcd/clearingday/v1
Schemes : HTTPS
1.4. Tags
-
calendar : Clearing Day Calendar
Informations about future clearing days can be found here. -
healthcheck : System Healthcheck
This allows to check the basic state of the system (can it be reached, does it respond).
2. Resources
2.1. Calendar
Clearing Day Calendar
Informations about future clearing days can be found here.
2.1.1. GET Calendar in JSON Format
GET /calendar
Description
Returns the clearing day calendar data as a JSON object.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Query |
calendarDay |
Calendar day (according to ISO 8601) that should be returned by the API call. If not specified all available, future entries are returned. |
string (date) |
Query |
serviceIdentification |
Service identification that should be returned by the API call. If not specified all available services are returned. |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Clearing day calendar in JSON format |
|
default |
Unexpected error. |
Produces
-
application/json
2.1.2. HEAD Calendar in JSON Format
HEAD /calendar
Description
Clearing day calendar file in JSON format (only head, no content).
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Query |
calendarDay |
Calendar day (according to ISO 8601) that should be returned by the API call. If not specified all available, future entries are returned. |
string (date) |
Query |
serviceIdentification |
Service identification that should be returned by the API call. If not specified all available services are returned. |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Content can be downloaded with GET method. |
No Content |
default |
Unexpected error. |
No Content |
2.1.3. GET Calendar File in CSV Format
GET /calendar.csv
Description
Clearing day calendar file in CSV format, with header row. The file encoding corresponds to the Unicode character set UTF-8 and must be read accordingly (umlauts, etc.).
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Query |
calendarDay |
Calendar day (according to ISO 8601) that should be returned by the API call. If not specified all available, future entries are returned. |
string (date) |
Query |
serviceIdentification |
Service identification that should be returned by the API call. If not specified all available services are returned. |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Clearing day calendar file in CSV format. |
No Content |
default |
Unexpected error. |
Produces
-
text/csv
2.1.4. HEAD Calendar in CSV Format
HEAD /calendar.csv
Description
Clearing day calendar file in CSV format (only head, no content).
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Query |
calendarDay |
Calendar day (according to ISO 8601) that should be returned by the API call. If not specified all available, future entries are returned. |
string (date) |
Query |
serviceIdentification |
Service identification that should be returned by the API call. If not specified all available services are returned. |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Content can be downloaded with GET method. |
No Content |
default |
Unexpected error. |
No Content |
2.2. Healthcheck
System Healthcheck
This allows to check the basic state of the system (can it be reached, does it respond).
2.2.1. GET Health Check
GET /healthcheck
Description
Returns a status message of the system.
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Healthcheck successful |
|
default |
Unexpected error. |
Produces
-
application/json
2.2.2. HEAD Health Check
HEAD /healthcheck
Description
Returns a status message of the system (only head, no content).
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Content can be downloaded with GET method. |
No Content |
default |
Unexpected error. |
No Content |
3. Definitions
3.1. ClearingDayCalendarJsonResponse
Toplevel element that contains metadata and clearing day calendar entries.
| Name | Schema |
|---|---|
metaData |
|
entries |
< ClearingDayCalendarJsonResponseEntry > array |
3.2. ClearingDayCalendarMetaData
Information about the validity and creation stamp.
| Name | Description | Schema |
|---|---|---|
createdStamp |
Date and time (according to ISO 8601) at which this response was created. |
string (date-time) |
3.3. ClearingDayCalendarJsonResponseEntry
Contains clearing day information for a specific calendar date.
| Name | Description | Schema |
|---|---|---|
calendarDay |
Calendar day (according to ISO 8601) of the record. All dependent information can be found as child elements. |
string (date) |
dayOfWeek |
Day of week of the current record in english. This redundant information is only available to support readability. |
string |
services |
< Service > array |
3.4. Service
Clearing day information for a specific service (e.g. SIC RTGS service or SIC IP service). This always includes the currently valid clearing day and may include planned downtimes and planned clearing day changes - if any.
| Name | Description | Schema |
|---|---|---|
serviceIdentification |
Values for Production Services: PCR_P; PER_P; PCI_P |
string |
serviceDescription |
Additional information to the serviceIdentification. No predefined values. |
string |
clearingDay |
The clearing day that is active on the start (00:00) of the related calendar day. |
string (date) |
scheduledDowntimes |
Planned downtime(s) of the service on this calendar day. If a downtime does not end by midnight, the end is 24:00 and the downtime continues at 00:00 on the next calendar day. |
< Duration > array |
scheduledClearingDayChange |
3.5. ScheduledClearingDayChange
Used if a clearing day change is scheduled for the calendar date. Depending on the service certain child-elements are available:
a) clearing stops (SIC RTGS and euroSIC RTGS service)
b) cut-offs for euroSIC RTGS service
c) the next clearing day scheduled
The date-time fields are structured according to RFC3339, section 5.6 in ISO 8601 with timezone and milliseconds.
| Name | Description | Schema |
|---|---|---|
scheduledClearingStop1 |
Clearing stop 1 date and time. |
string (date-time) |
scheduledClearingStop2 |
Clearing stop 2 date and time. |
string (date-time) |
scheduledClearingStop3 |
Clearing stop 3 date and time. |
string (date-time) |
scheduledCutOff1 |
Cut off 1 date and time. |
string (date-time) |
scheduledCutOff2 |
Cut off 2 date and time. |
string (date-time) |
nextClearingDay |
The clearing day that starts after day end processing (SIC and euroSIC RTGS service) or after day change (SIC IP service). |
string (date) |
3.6. Duration
A duration composed of start and end. The date-time fields are structured according to RFC3339, section 5.6 in ISO 8601 with timezone and milliseconds.
| Name | Description | Schema |
|---|---|---|
startDateTime |
Start date and time of the duration. |
string (date-time) |
endDateTime |
End date and time of the duration. |
string (date-time) |
3.7. Problem
| Name | Description | Schema |
|---|---|---|
type |
An absolute URI that identifies the problem type. |
string (uri) |
title |
A short, human readable summary of the problem type. |
string |
status |
The HTTP status code generated by the origin server for this occurrence |
integer (int32) |
detail |
A human readable explanation specific to this occurrence of the |
string |
instance |
An absolute URI that identifies the specific occurrence of the problem. |
string (uri) |
metadata |
3.8. GenericObject
Structured type that contains an object and its type.
| Name | Description | Schema |
|---|---|---|
@type |
The field "@type" contains a URI/name identifying the type. Example: "@type": "types.example.com/standard/id". |
string |
data |
An object of type @type containing custom fields. |
object |
3.9. HealthCheckResponse
| Name | Description | Schema |
|---|---|---|
message |
Response message from health check. |
string |
requestDateTime |
According to RFC3339, section 5.6 in ISO 8601 with timezone and milliseconds. |
string (date-time) |
receivedHeaders |
< receivedHeaders > array |
|
environmentStage |
The instance to which the request was sent to. |
string |
applicationVersion |
The version of the API backend. |
string |
apiVersion |
The version of the API. |
string |
receivedHeaders
| Name | Description | Schema |
|---|---|---|
headerName |
The name of the provided header. |
string |
headerValue |
As received |
string |