---
title: "Service"
url: "https://apiportal.six-group.com/apis/sic-clearing-day-calendar-api-v1-ch-v1/versions/0f2fee1c-ce1f-4323-8b82-cfed13b6e3f3/schemas/Service"
---

> Full API specification: https://apiportal.six-group.com/apis/sic-clearing-day-calendar-api-v1-ch-v1/versions/0f2fee1c-ce1f-4323-8b82-cfed13b6e3f3.md

# 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.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Clearing Day Calendar v1
  version: 1.0 (generated 2024-03-27T17:02:01Z)
servers:
  - url: https://api.six-group.com/api/epcd/clearingday/v1
  - url: https://api.p2p.six-group.com/api/epcd/clearingday/v1
  - url: https://api.fip.six-group.com/api/epcd/clearingday/v1
components:
  schemas:
    Duration:
      required:
        - endDateTime
        - startDateTime
      type: object
      properties:
        startDateTime:
          type: string
          description: Start date and time of the duration.
          format: date-time
          example: 2024-12-23T12:00:00+01:00
        endDateTime:
          type: string
          description: End date and time of the duration.
          format: date-time
      description: 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.
    ScheduledClearingDayChange:
      required:
        - nextClearingDay
      type: object
      properties:
        scheduledClearingStop1:
          type: string
          description: Clearing stop 1 date and time.
          format: date-time
          example: 2024-12-23T17:00:00+01:00
        scheduledClearingStop2:
          type: string
          description: Clearing stop 2 date and time.
          format: date-time
          example: 2024-12-23T18:00:00+01:00
        scheduledClearingStop3:
          type: string
          description: Clearing stop 3 date and time.
          format: date-time
          example: 2024-12-23T18:15:00+01:00
        scheduledCutOff1:
          type: string
          description: Cut off 1 date and time.
          format: date-time
          example: 2024-12-23T16:30:00+01:00
        scheduledCutOff2:
          type: string
          description: Cut off 2 date and time.
          format: date-time
          example: 2024-12-23T17:30:00+01:00
        nextClearingDay:
          type: string
          description: The clearing day that starts after day end processing (SIC and
            euroSIC RTGS service) or after day change (SIC IP service).
          format: date
          example: 2024-12-24
      description: >
        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.
    Service:
      required:
        - clearingDay
        - serviceDescription
        - serviceIdentification
      type: object
      properties:
        serviceIdentification:
          maxLength: 10
          minLength: 1
          type: string
          description: |
            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
          example: PCR_P
        serviceDescription:
          maxLength: 250
          minLength: 1
          type: string
          description: Additional information to the serviceIdentification. No predefined
            values.
          example: "SIC-RTGS-Service: External test environment for tests with production
            data and the current development status of the next release"
        clearingDay:
          type: string
          description: The clearing day that is active on the start (00:00) of the related
            calendar day.
          format: date
          example: 2024-12-23
        scheduledDowntimes:
          type: array
          description: 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.
          items:
            $ref: "#/components/schemas/Duration"
        scheduledClearingDayChange:
          $ref: "#/components/schemas/ScheduledClearingDayChange"
      description: 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.
```