---
title: "GET Calendar File in CSV Format"
url: "https://apiportal.six-group.com/apis/sic-clearing-day-calendar-api-v1-ch-v1/versions/0f2fee1c-ce1f-4323-8b82-cfed13b6e3f3/operations/getClearingDayCalendarCsv"
---

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

# GET Calendar File in CSV Format

`GET` `/calendar.csv`

Operation ID: `getClearingDayCalendarCsv`

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

## Query parameters

- `calendarDay` (string, date, optional) - Calendar day (according to ISO 8601) that should be returned by the API call. If not specified all available, future entries are returned.
- `serviceIdentification` (string, optional) - Service identification that should be returned by the API call. If not specified all available services are returned.

## Responses

- `200` - Clearing day calendar file in CSV format.
- `default` - Unexpected error.

## 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
paths:
  /calendar.csv:
    parameters:
      - $ref: "#/components/parameters/query_calendarDay"
      - $ref: "#/components/parameters/query_serviceIdentification"
    get:
      tags:
        - calendar
      summary: GET Calendar File in CSV Format
      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.).
      operationId: getClearingDayCalendarCsv
      responses:
        "200":
          description: Clearing day calendar file in CSV format.
          content: {}
        default:
          description: Unexpected error.
          content:
            text/csv:
              schema:
                $ref: "#/components/schemas/Problem"
components:
  parameters:
    query_calendarDay:
      name: calendarDay
      in: query
      description: Calendar day (according to ISO 8601) that should be returned by the
        API call. If not specified all available, future entries are returned.
      required: false
      style: form
      explode: true
      schema:
        type: string
        format: date
    query_serviceIdentification:
      name: serviceIdentification
      in: query
      description: Service identification that should be returned by the API call. If
        not specified all available services are returned.
      required: false
      style: form
      explode: true
      schema:
        type: string
  schemas:
    Problem:
      required:
        - detail
        - status
        - title
      type: object
      properties:
        type:
          type: string
          description: >
            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.
          format: uri
          example: /problems/REQUEST_PARAMETER_VALIDATION_FAILED
          default: about:blank
        title:
          type: string
          description: |
            A short, human readable summary of the problem type.
          example: Request parameter has missing or invalid values
        status:
          maximum: 600
          exclusiveMaximum: true
          minimum: 100
          type: integer
          description: >
            The HTTP status code generated by the origin server for this
            occurrence

            of the problem.
          format: int32
          example: 400
        detail:
          type: string
          description: |
            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.
        instance:
          type: string
          description: >
            An absolute URI that identifies the specific occurrence of the
            problem.

            It may or may not yield further information if dereferenced.
          format: uri
          example: /api/epcd/bankmaster/v3/public/errors/EPCD0090000001/provided-D
        metadata:
          $ref: "#/components/schemas/GenericObject"
    GenericObject:
      required:
        - "@type"
        - data
      type: object
      properties:
        "@type":
          type: string
          description: >
            The field "@type" contains a URI/name identifying the type. Example:
            "@type": "types.example.com/standard/id".
        data:
          type: object
          properties: {}
          description: |
            An object of type @type containing custom fields.
      description: |
        Structured type that contains an object and its type.
      example: >
        When associated with a 'Problem', it typically contains values which
        caused the failure and similar. May not contain sensitive CID.
```