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
optional

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
optional

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
optional

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
optional

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
optional

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
optional

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
optional

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
optional

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
required

entries
required

3.2. ClearingDayCalendarMetaData

Information about the validity and creation stamp.

Name Description Schema

createdStamp
required

Date and time (according to ISO 8601) at which this response was created.
Example : "2024-12-21T10:52:05.1904957+01:00"

string (date-time)

3.3. ClearingDayCalendarJsonResponseEntry

Contains clearing day information for a specific calendar date.

Name Description Schema

calendarDay
required

Calendar day (according to ISO 8601) of the record. All dependent information can be found as child elements.
Example : "2024-12-23"

string (date)

dayOfWeek
required

Day of week of the current record in english. This redundant information is only available to support readability.
Length : 1 - 15
Example : "Wednesday"

string

services
required

< 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
required

Values for Production Services: PCR_P; PER_P; PCI_P
Values for Test environments:
- SIC RTGS service: XCR_E; XCR_P; ACR_E; ACR_P
- SIC IP service: XCI_E; ACI_E; XCI_P; ACI_P; VCI_E; VCI_P
- euroSIC RTGS service: XER_E; XER_P; AER_E; AER_P
Length : 1 - 10
Example : "PCR_P"

string

serviceDescription
required

Additional information to the serviceIdentification. No predefined values.
Length : 1 - 250
Example : "SIC-RTGS-Service: External test environment for tests with production data and the current development status of the next release"

string

clearingDay
required

The clearing day that is active on the start (00:00) of the related calendar day.
Example : "2024-12-23"

string (date)

scheduledDowntimes
optional

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
optional

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
optional

Clearing stop 1 date and time.
Example : "2024-12-23T17:00:00.0000000+01:00"

string (date-time)

scheduledClearingStop2
optional

Clearing stop 2 date and time.
Example : "2024-12-23T18:00:00.0000000+01:00"

string (date-time)

scheduledClearingStop3
optional

Clearing stop 3 date and time.
Example : "2024-12-23T18:15:00.0000000+01:00"

string (date-time)

scheduledCutOff1
optional

Cut off 1 date and time.
Example : "2024-12-23T16:30:00.0000000+01:00"

string (date-time)

scheduledCutOff2
optional

Cut off 2 date and time.
Example : "2024-12-23T17:30:00.0000000+01:00"

string (date-time)

nextClearingDay
required

The clearing day that starts after day end processing (SIC and euroSIC RTGS service) or after day change (SIC IP service).
Example : "2024-12-24"

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
required

Start date and time of the duration.
Example : "2024-12-23T12:00:00.0000000+01:00"

string (date-time)

endDateTime
required

End date and time of the duration.
Example : "2024-12-23T24:00:00.0000000+01:00"

string (date-time)

3.7. Problem

Name Description Schema

type
optional

An absolute URI that identifies the problem type.
We may provide human-readable documentation for the problem type in the future, when the URI is dereferenced.
Default : "about:blank"
Example : "/problems/REQUEST_PARAMETER_VALIDATION_FAILED"

string (uri)

title
required

A short, human readable summary of the problem type.
Example : "Request parameter has missing or invalid values"

string

status
required

The HTTP status code generated by the origin server for this occurrence
of the problem.
Minimum value : 100
Maximum value (exclusive) : 600
Example : 400

integer (int32)

detail
required

A human readable explanation specific to this occurrence of the
problem.
Example : "The submitted request contains invalid or missing request parameters which cannot be processed."

string

instance
optional

An absolute URI that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.
Example : "/api/epcd/bankmaster/v3/public/errors/EPCD0090000001/provided-D"

string (uri)

metadata
optional

3.8. GenericObject

Structured type that contains an object and its type.

Name Description Schema

@type
required

The field "@type" contains a URI/name identifying the type. Example: "@type": "types.example.com/standard/id".

string

data
required

An object of type @type containing custom fields.

object

3.9. HealthCheckResponse

Name Description Schema

message
required

Response message from health check.
Maximal length : 100
Example : "The health check GET request was successfully received and processed."

string

requestDateTime
required

According to RFC3339, section 5.6 in ISO 8601 with timezone and milliseconds.
Example : "2024-12-21T10:52:05.1904957+01:00"

string (date-time)

receivedHeaders
required

< receivedHeaders > array

environmentStage
required

The instance to which the request was sent to.
Example : "X1"

string

applicationVersion
required

The version of the API backend.
Example : "4.5.0-julia"

string

apiVersion
required

The version of the API.
Example : "1.0.23"

string

receivedHeaders

Name Description Schema

headerName
optional

The name of the provided header.
Example : "Accept"

string

headerValue
optional

As received
Example : "application/json"

string