Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede


Release Information1.0.3
Target audienceThis documentation is intended for developers and system integrators which enable customer systems for interaction with the SASIS CPR API.
Summary

The Care Provider Register API is the public API to connect customer specific solutions to the SASIS care provider register in a well structured an secured manner. 

The reader of this documentation will find the API description in detail as well as further information about the access and authorization mechanisms.




Panel
titleContent

Table of Contents


Introduction

The Care Provider Register (CPR) API provides a possibility to connect enterprise systems to SASIS internal data structures to maintain and interrogate care providers and their clearing numbers. 

The API is designed to replace existing file based data exchange with a high performance and secure online interface. The API itself is REST based and supports tenant specific requests which is handled based on the authentication of the API client.

The main functionality is:

  • Interrogation of clearing number (ZSR/RCC/CPR number) or employee number (K-Nummer/Numéro C/Numero di controllo) overviews and details.
  • Interrogation of comments on health services.
  • Interrogation of filtered clearing numbers and/or employee numbers based on subscription search options.
  • Maintenance of care provider certification periods (mainly used by health service certifiers).


API Specification

Expand
titleOpen API Specification


HTML
<!-- Models like EmployeeNumberDetailViewItem generate errors due to a SwaggerUI bug (https://github.com/swagger-api/swagger-ui/issues/3366). The errors are currently suppressed via CSS ('Space Tools' -> 'Look and Feel' -> 'Stylesheet'; 'Confluence Administrator' role needed to change this configuration). -->


Panel



Open API (Swagger) Integration for Confluence
{
  "openapi": "3.0.1",
  "info": {
    "title": "CPR API v1",
    "description": "This is the CPR API v1 documentation (binary version v1.0.3.29.StageNext).",
    "contact": {
      "name": "CPR API Support",
      "email": "support@sasis.ch"
    },
    "version": "1"
  },
  "servers": [
    {
      "url": "/ApiGateway"
    }
  ],
  "paths": {
    "/api/v1/careprovidercertification": {
      "post": {
        "tags": [
          "CareProviderCertification"
        ],
        "summary": "Creates or updates care provider certification periods and health services of one specific care provider. The request must always contain the full set historicised data.",
        "requestBody": {
          "description": "",
          "content": {
            "application/json-patch+json": {
              "schema": {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CareProviderCertificationRequest"
              }
            },
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CareProviderCertificationRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CareProviderCertificationRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CareProviderCertificationRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Success. The provided data has been accepted and is scheduled to be applied asynchronously."
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "description": "Error response"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "description": "Error response"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          }
        }
      }
    },
    "/api/v1/clearingnumbers": {
      "post": {
        "tags": [
          "ClearingNumbers"
        ],
        "summary": "Returns details for specific clearing numbers (ZSR/RCC/CPR). The returned data is to be specified as a list of plain clearing numbers as parameters.",
        "requestBody": {
          "description": "A list of plain clearing numbers. <br />Validations:<ul><li>Max. 500 clearing numbers per request.</li></ul>",
          "content": {
            "application/json-patch+json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.ClearingNumberDetailViewItem"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "description": "Error response"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          }
        }
      }
    },
    "/api/v1/employeenumbers": {
      "post": {
        "tags": [
          "EmployeeNumbers"
        ],
        "summary": "Returns details for specific employees. The returned data is to be specified as a list of plain employee numbers (K-Nummer / Numéro C / Numero di controllo) as parameters.",
        "requestBody": {
          "description": "A list of plain employee numbers. <br />Validations:<ul><li>Max. 500 employee numbers per request.</li></ul>",
          "content": {
            "application/json-patch+json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.EmployeeNumberDetailViewItem"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "description": "Error response"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          }
        }
      }
    },
    "/api/v1/healthservices/comments": {
      "get": {
        "tags": [
          "HealthServices"
        ],
        "summary": "Get all comments available on health services.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.HealthServiceCommentViewItem"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          }
        }
      }
    },
    "/api/v1/numbers": {
      "get": {
        "tags": [
          "Numbers"
        ],
        "summary": "Returns a paged list of clearing numbers (ZSR/RCC/CPR) and/or employee numbers (K-Nummer / Numéro C / Numero di controllo) by subscription search options.",
        "parameters": [
          {
            "name": "searchoptions",
            "in": "query",
            "description": "The subscription search options. <br />Validations:<ul><li>Must be at least one of the listed search options.</li></ul>",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.SearchOption"
              }
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The number of entries used as offset to retrieve the next page. The next offset it must be calculated as sum of the previously used offset and the page size (limit).<br />Validations:<ul><li>-</li></ul>",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximal number of entries in the next returned page. Receiving a recordCount smaller than the limit indicates that the last page has been reached.<br />Validations:<ul><li>-</li></ul>",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "modifiedfrom",
            "in": "query",
            "description": "Numbers modified after this date (string in ISO time format, e.g: 2020-01-20T07:10:00Z).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.StringBulkResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          }
        }
      }
    },
    "/api/v1/numbers/list": {
      "post": {
        "tags": [
          "Numbers"
        ],
        "summary": "Returns basic information about clearing and/or employee numbers. The returned data is to be specified as a list of plain clearing (ZSR/RCC/CPR) and/or employee numbers (K-Nummer / Numéro C / Numero di controllo) as parameters.",
        "requestBody": {
          "description": "A list of clearing (ZSR/RCC/CPR) and/or employee numbers (K-Nummer / Numéro C / Numero di controllo). <br />Validations:<ul><li>Max. 500 employee numbers per request.</li></ul>",
          "content": {
            "application/json-patch+json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.NumberListViewItem"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "description": "Error response"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          }
        }
      }
    },
    "/api/v1/subscribers": {
      "get": {
        "tags": [
          "Subscribers"
        ],
        "summary": "Returns all available subscriber names.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          }
        }
      }
    },
    "/api/v1/unregisteredcareproviders": {
      "post": {
        "tags": [
          "UnregisteredCareProviders"
        ],
        "summary": "Returns details for specific unregistered Medreg care provider. The returned data is to be specified as a list of plain global location numbers passed as parameters.",
        "requestBody": {
          "description": "A list of plain global location numbers. <br />Validations:<ul><li>Max. 500 global location numbers per request.</li></ul>",
          "content": {
            "application/json-patch+json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.Medical"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "description": "Error response"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.ComplementaryTherapistCertificationLabel": {
        "enum": [
          "ASCA",
          "APTN",
          "NVS_SPAK",
          "ESKAMED_EMR"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.HealthServicePeriodRequest": {
        "type": "object",
        "properties": {
          "externalId": {
            "type": "string",
            "description": "The identification of the health service in the system of the API consumer. <br />Validations:<ul><li>Must contain numbers only.</li></ul>",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' must be provided.",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CertificationPeriodRequest": {
        "type": "object",
        "properties": {
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' must be provided.",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.HealthServicePeriodSubscriberRequest": {
        "required": [
          "subscriber"
        ],
        "type": "object",
        "properties": {
          "subscriber": {
            "type": "string",
            "description": "Identification of the subscriber according to the subscribers-Endpoint."
          },
          "externalId": {
            "type": "string",
            "description": "The identification of the health service in the system of the API consumer. <br />Validations:<ul><li>Must contain numbers only.</li></ul>",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' must be provided.",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CertificationPeriodSubscriberRequest": {
        "type": "object",
        "properties": {
          "subscriber": {
            "type": "string",
            "description": "Identification of the subscriber according to the subscribers-Endpoint.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' must be provided.",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CareProviderCertificationRequest": {
        "required": [
          "externalId",
          "label"
        ],
        "type": "object",
        "properties": {
          "clearingNumber": {
            "type": "string",
            "description": "The clearing number (=ZSR-Nummer) identifying the care provider uniquely. <br />Validations:<ul><li>Clearing number check digit accoring to the documentation.</li></ul>",
            "nullable": true
          },
          "externalId": {
            "type": "string",
            "description": "The identification of the care provider in the system of the API consumer. <br />Validations:<ul><li>Must contain numbers only.</li></ul>"
          },
          "label": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.ComplementaryTherapistCertificationLabel"
              }
            ],
            "description": "Certification label."
          },
          "careProviderHealthServices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.HealthServicePeriodRequest"
            },
            "description": "Health services for the care provider.",
            "nullable": true
          },
          "careProviderCertificationPeriods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CertificationPeriodRequest"
            },
            "description": "Certification periods for the care provider.",
            "nullable": true
          },
          "subscriberHealthServices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.HealthServicePeriodSubscriberRequest"
            },
            "description": "Health services per subscriber.",
            "nullable": true
          },
          "subscriberCertificationPeriods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.Certifier.CertificationPeriodSubscriberRequest"
            },
            "description": "Certification periods per subscriber.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The payload of a CareProviderCertification request."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Canton": {
        "enum": [
          "AG",
          "AI",
          "AR",
          "BS",
          "BL",
          "BE",
          "FR",
          "GE",
          "GL",
          "GR",
          "JU",
          "LU",
          "NE",
          "NW",
          "OW",
          "SH",
          "SZ",
          "SO",
          "SG",
          "TG",
          "TI",
          "UR",
          "VS",
          "VD",
          "ZG",
          "ZH"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation": {
        "type": "object",
        "properties": {
          "de": {
            "type": "string",
            "nullable": true
          },
          "fr": {
            "type": "string",
            "nullable": true
          },
          "it": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberSuffix": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The region name",
            "nullable": true
          },
          "canton": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Canton"
              }
            ],
            "description": "When available the name of the swiss canton.",
            "nullable": true
          },
          "cantonTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "suffixNumber": {
            "type": "string",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The clearing number suffix (=StammKanton). This can be a swiss canton or any other grouping entity."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.ClearingNumberCompensationType": {
        "enum": [
          "UNKNOWN",
          "AMB_T_GSTAT_TP",
          "TIERS_GARANT",
          "TIERS_PAYANT",
          "CONTRACT_BASED_TIERS_PAYANT_OR_GARANT"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberCompensation": {
        "type": "object",
        "properties": {
          "clearingNumberCompensationType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.ClearingNumberCompensationType"
              }
            ],
            "description": "The clearing number compensation type."
          },
          "clearingNumberCompensationTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for the clearing number compensation (Entschädigungscode)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.ClearingNumberLawType": {
        "enum": [
          "KVG_VVG",
          "PARTIAL_KVG_VVG",
          "VVG",
          "UVG_MV_IV"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberLaw": {
        "type": "object",
        "properties": {
          "clearingNumberLawType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.ClearingNumberLawType"
              }
            ],
            "description": "The clearing number law type."
          },
          "clearingNumberLawTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The clearing number law (=Zulassung)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.AddressFormType": {
        "enum": [
          "UNKNOWN",
          "MR",
          "MS"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.AcademicTitle": {
        "enum": [
          "UNKNOWN",
          "DR",
          "PROF_DR",
          "DRES",
          "DR_MED",
          "PD_DR_MED",
          "PROF_DR_MED",
          "MED_PRAKT",
          "MED_DENT",
          "DR_MED_DENT",
          "PD_DR_MED_DENT",
          "PROF_DR_MED_DENT"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Country": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The country name.",
            "nullable": true
          },
          "twoLetterCountryCode": {
            "type": "string",
            "description": "The ISO 3166-1 alpha-2 two letter country code.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The country (=Land)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Gender": {
        "enum": [
          "UNKNOWN",
          "MALE",
          "FEMALE",
          "OTHERS"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.LegalFormType": {
        "enum": [
          "SOLE_PROPRIETORSHIP",
          "GENERAL_PARTNERSHIP",
          "CORPORATION",
          "LIMITED_LIABILITY_COMPANY",
          "COOPERATIVE",
          "ASSOCIATION",
          "FOUNDATION",
          "PUBLIC_SECTOR_INSTITUTION",
          "BRANCH",
          "LIMITED_PARTNERSHIP",
          "FOREIGN_BRANCH",
          "CORPORATION_WITH_UNLIMITED_PARTNERS",
          "AFFILIATION",
          "LIMITED_COMPANY",
          "NON_PROFIT_LIMITED_LIABILITY_COMPANY"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Language": {
        "enum": [
          "DE",
          "FR",
          "IT"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PostalAddress": {
        "type": "object",
        "properties": {
          "postOfficeBoxText": {
            "type": "string",
            "description": "Post office box text.",
            "nullable": true
          },
          "postOfficeBoxNumber": {
            "type": "integer",
            "description": "Post office box number.",
            "format": "int32",
            "nullable": true
          },
          "street": {
            "type": "string",
            "description": "The street with street number (=Strasse).",
            "nullable": true
          },
          "addressAddition": {
            "type": "string",
            "description": "The address addition (=Adresszusatz).",
            "nullable": true
          },
          "place": {
            "type": "string",
            "description": "The place/city (=Ort).",
            "nullable": true
          },
          "postalCode": {
            "type": "string",
            "description": "The postal code, national and international (=PLZ).",
            "nullable": true
          },
          "country": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Country"
              }
            ],
            "description": "The country.",
            "nullable": true
          },
          "canton": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Canton"
              }
            ],
            "description": "When available the name of the swiss canton.",
            "nullable": true
          },
          "cantonTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The postal address (=Postadresse)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.PhoneNumberType": {
        "enum": [
          "LANDLINE",
          "MOBILE",
          "FAX"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PhoneNumber": {
        "type": "object",
        "properties": {
          "phoneNumberType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.PhoneNumberType"
              }
            ],
            "description": "The phone number type.",
            "nullable": true
          },
          "phoneNumberTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "The phone number, formatted as E.164.",
            "nullable": true
          },
          "country": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Country"
              }
            ],
            "description": "The phone number country.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The phone number."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmailAddress": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email address.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The email address."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Contact": {
        "type": "object",
        "properties": {
          "language": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Language"
              }
            ],
            "description": "The language to be used when communicating with this person.",
            "nullable": true
          },
          "languageTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "postalAddress": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PostalAddress"
              }
            ],
            "description": "The postal address.",
            "nullable": true
          },
          "phoneNumbers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PhoneNumber"
            },
            "description": "The phone numbers.",
            "nullable": true
          },
          "emailAddresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmailAddress"
            },
            "description": "The email addresses.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The person's contact details."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Party": {
        "required": [
          "__typename"
        ],
        "type": "object",
        "properties": {
          "__typename": {
            "type": "string"
          },
          "contact": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Contact"
              }
            ],
            "nullable": true
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "discriminator": {
          "propertyName": "__typename"
        }
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyCareProvider": {
        "required": [
          "__typename"
        ],
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Party"
          }
        ],
        "properties": {
          "legalFormType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.LegalFormType"
              }
            ],
            "nullable": true
          },
          "legalFormTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "organizationIdentificationNumber": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "discriminator": {
          "propertyName": "__typename"
        }
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyCareProviderNaturalPerson": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyCareProvider"
          }
        ],
        "properties": {
          "givenName": {
            "type": "string",
            "nullable": true
          },
          "callName": {
            "type": "string",
            "nullable": true
          },
          "familyName": {
            "type": "string",
            "nullable": true
          },
          "originalName": {
            "type": "string",
            "nullable": true
          },
          "globalLocationNumber": {
            "type": "string",
            "nullable": true
          },
          "addressFormType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.AddressFormType"
              }
            ]
          },
          "addressFormTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "academicTitle": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.AcademicTitle"
              }
            ]
          },
          "academicTitleTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "birthdate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "birthPlace": {
            "type": "string",
            "nullable": true
          },
          "birthCountry": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Country"
              }
            ],
            "nullable": true
          },
          "gender": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Gender"
              }
            ]
          },
          "genderTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "contact": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Contact"
              }
            ],
            "description": "The party contact details.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.OrganizingInstitutionType": {
        "enum": [
          "PRIVATE",
          "PUBLIC"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyCareProviderJuristicPerson": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyCareProvider"
          }
        ],
        "properties": {
          "firm": {
            "type": "string",
            "nullable": true
          },
          "organizingInstitutionType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.OrganizingInstitutionType"
              }
            ],
            "nullable": true
          },
          "organizingInstitutionTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "contact": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Contact"
              }
            ],
            "description": "The party contact details.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderParty": {
        "type": "object",
        "properties": {
          "party": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyCareProviderNaturalPerson"
              },
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyCareProviderJuristicPerson"
              }
            ],
            "description": "The care provider party (=Privatadresse).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for a care provider party (=Personendaten). For each point in time only one active mapping should exist."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Affiliation": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The affiliation name (=Verbandscode usf.). E.g. an organization code.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "An affiliation in an organisation (=Mitgliedschaft)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceComment": {
        "type": "object",
        "properties": {
          "commentTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "description": "Comment translations.",
            "nullable": true
          },
          "isExcluded": {
            "type": "boolean",
            "description": "Whether the health service is excluded."
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The health service specific comment."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthService": {
        "required": [
          "__typename"
        ],
        "type": "object",
        "properties": {
          "__typename": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "nameTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "externalId": {
            "type": "string",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean"
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "discriminator": {
          "propertyName": "__typename"
        }
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceCertifier": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthService"
          }
        ],
        "properties": {
          "affiliation": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Affiliation"
              }
            ],
            "description": "The health service affiliation, e.g. EMR, ASCA etc.",
            "nullable": true
          },
          "comments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceComment"
            },
            "description": "Health service comments",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The certifier health service (=Zertifizierer-Methode)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthService": {
        "required": [
          "__typename"
        ],
        "type": "object",
        "properties": {
          "__typename": {
            "type": "string"
          },
          "startDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean"
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "discriminator": {
          "propertyName": "__typename"
        }
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthServiceCertifier": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthService"
          }
        ],
        "properties": {
          "healthService": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceCertifier"
              }
            ],
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceGroup": {
        "type": "object",
        "properties": {
          "externalId": {
            "type": "string",
            "description": "Health service group external id (LEA-Leistungsbereich/-Leistungsgruppe abbreviation)",
            "nullable": true
          },
          "parentExternalId": {
            "type": "string",
            "description": "The parent health service group external id (LEA-Leistungsbereich abbreviation)",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The health service group (=LEA-Leistungsbereich/-Leistungsgruppe)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceHospital": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthService"
          }
        ],
        "properties": {
          "healthServiceGroup": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceGroup"
              }
            ],
            "description": "Health service group (LEA Leistungsbereich, Leistungsgruppe)",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The hospital health service (=LEA-Mandat)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceCantonMandate": {
        "type": "object",
        "properties": {
          "canton": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Canton"
              }
            ]
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The hospital health service canton mandat (=LeaDatModellKantonEinschraenkung)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthServiceHospital": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthService"
          }
        ],
        "properties": {
          "healthService": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceHospital"
              }
            ],
            "nullable": true
          },
          "healthServiceCantonMandate": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.HealthServiceCantonMandate"
              }
            ],
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.QualificationType": {
        "enum": [
          "DIPLOMA",
          "CERTIFICATE",
          "CONTINUING_EDUCATION_CERTIFICATE",
          "EXPERTISE_AREA",
          "SKILLS",
          "ADMISSION",
          "ADDITIONAL_CERTIFICATE",
          "PROFICIENCY_TEST"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.BusinessScope": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The business scope's name.",
            "nullable": true
          },
          "parentBusinessScope": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.BusinessScope"
              }
            ],
            "description": "The optional parent business scope (=PartnerartObergruppe). Available for sub business scopes only (=PartnerartUntergruppe).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The business scope devided into parent business scope (=PartnerartObergruppe) and sub business scope (=PartnerartUntergruppe)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Qualification": {
        "type": "object",
        "properties": {
          "qualificationType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.QualificationType"
              }
            ],
            "description": "The qualification type.",
            "nullable": true
          },
          "qualificationTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "The qualification name.",
            "nullable": true
          },
          "affiliation": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Affiliation"
              }
            ],
            "description": "The health service affiliation, e.g. FMH etc.",
            "nullable": true
          },
          "businessScope": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.BusinessScope"
              }
            ],
            "description": "The business scope (=PartnerartObergruppe/-Untergruppe).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The qualification (=Qualifikation)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderQualification": {
        "type": "object",
        "properties": {
          "country": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Country"
              }
            ],
            "description": "The country (=Land) where the qualification has been attained.",
            "nullable": true
          },
          "qualification": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Qualification"
              }
            ],
            "description": "The qualification (=Qualifikation).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for care provider qualifications (=Qualifikationen)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.AffiliationBroker": {
        "enum": [
          "TARIF_SUISSE",
          "ASPI",
          "PHYSIO_SWISS"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderAffiliation": {
        "type": "object",
        "properties": {
          "externalId": {
            "type": "string",
            "description": "The care provider membership id (=Mitgliedernummer).",
            "nullable": true
          },
          "affiliationBroker": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.AffiliationBroker"
              }
            ],
            "description": "The affiliation broker. The institution providing the affiliation to the care provider.",
            "nullable": true
          },
          "affiliationBrokerTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "affiliation": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Affiliation"
              }
            ],
            "description": "The affiliation (=Verband etc.).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The care provider affiliation."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.EmploymentType": {
        "enum": [
          "REGULAR",
          "EXECUTIVE"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.LicenseState": {
        "enum": [
          "PENDING",
          "APPROVED",
          "DECLINED"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.LicenseRestrictionType": {
        "enum": [
          "UNKNOWN",
          "NINETY_DAY_REGULATION",
          "REGION",
          "ACTIVITY",
          "SUSPENSION",
          "ADMISSION_MUTATION_LOCK",
          "OKP_EXCLUSION"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.LicenseRestrictionReasonType": {
        "enum": [
          "UNKNOWN",
          "TERMINATION_OF_ACTIVITY",
          "REVOCATION_OF_BA_B_LICENSE",
          "CHANGE_OF_LOCATION",
          "TERMINATION_BY_DEATH",
          "CARE_PROVIDER_MERGER",
          "CHANGE_OF_HANDS",
          "OUT_OF_CONTRACT",
          "CHANGE_OF_REGION",
          "CHANGE_OF_BUSINESS_SCOPE",
          "MISSING_CERTIFICATION",
          "COMPLEMENTARY_CARE_PROVIDER_MERGER",
          "UNPAYED_SERVICE_FEE"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.LicenseRestriction": {
        "type": "object",
        "properties": {
          "licenseRestrictionType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.LicenseRestrictionType"
              }
            ],
            "description": "License restriction type (=Beschränkungstyp).",
            "nullable": true
          },
          "licenseRestrictionTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "licenseRestrictionReasonType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.LicenseRestrictionReasonType"
              }
            ],
            "description": "License restriction reason type (=Beschränkungsgrund).",
            "nullable": true
          },
          "licenseRestrictionReasonTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "reason": {
            "type": "string",
            "description": "Licsense restriction reason (=Beschränkungstext).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "License restrictions (=Beschränkung, Sistierung, Sperrung, Ausstand)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.License": {
        "type": "object",
        "properties": {
          "licenseState": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.LicenseState"
              }
            ],
            "description": "The licensing state.",
            "nullable": true
          },
          "licenseStateTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "canton": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Canton"
              }
            ],
            "description": "When available the name of the swiss canton.",
            "nullable": true
          },
          "cantonTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "country": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Country"
              }
            ],
            "description": "The country.",
            "nullable": true
          },
          "licenseRestrictions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.LicenseRestriction"
            },
            "description": "License restrictions (=Beschränkung, Sistierung, Sperrung, Ausstand).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The canton based license (=Zulassung) including restrictions for this license."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmployerRelation": {
        "type": "object",
        "properties": {
          "clearingNumber": {
            "type": "string",
            "description": "The clearing number (=ZSR-Nummer).",
            "nullable": true
          },
          "isPublished": {
            "type": "boolean",
            "description": "The is active flag.",
            "nullable": true,
            "deprecated": true
          },
          "employmentType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.EmploymentType"
              }
            ],
            "description": "The employment type (=Anstellungstyp)",
            "nullable": true
          },
          "license": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.License"
              }
            ],
            "description": "The canton based license (=Zulassung).",
            "nullable": true
          },
          "employmentTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for the employer mapping (=Arbeitgeber)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmployeeNumber": {
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "description": "The employee number (=KNummer).",
            "nullable": true
          },
          "careProvider": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProvider"
              }
            ],
            "description": "The care provider (=Leistungserbringer).",
            "nullable": true
          },
          "businessScope": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.BusinessScope"
              }
            ],
            "description": "The business scope (=PartnerartObergruppe/-Untergruppe).",
            "nullable": true
          },
          "relatedEmployers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmployerRelation"
            },
            "description": "A mapping list of employers.",
            "nullable": true
          },
          "licenses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.License"
            },
            "description": "A list of licenses (=Zulassung KVG/VVG/UVG).",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The employee number (=KNummer)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProvider": {
        "type": "object",
        "properties": {
          "comment": {
            "type": "string",
            "description": "An optional comment value.",
            "nullable": true
          },
          "careProviderParties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderParty"
            },
            "description": "The care provider party (=Personendaten). Despite multiple records for each moment in time only one active party exists.",
            "nullable": true
          },
          "healthServices": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthServiceCertifier"
                },
                {
                  "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthServiceHospital"
                }
              ],
              "description": "The mapping details for care provider health services (=Zertifizierer Methoden)."
            },
            "description": "The care provider health service mappings (=Zertifizierer Methoden). For VVG care providers of complementary medicine only. When provided by external certifiers this list might contain multiple health service mappings for the same health service, but with diverging validity periods.",
            "nullable": true
          },
          "qualifications": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderQualification"
            },
            "description": "The care provider qualification mappings (=Qualifikationen).",
            "nullable": true
          },
          "affiliations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderAffiliation"
            },
            "description": "The care provider affiliation mappings (=Mitgliedschaften)",
            "nullable": true
          },
          "careProviderBusinesses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderBusiness"
            },
            "description": "The care provider businesses (=Zahlstellen). A care provider can manage multiple businesses.",
            "nullable": true
          },
          "employeeNumbers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmployeeNumber"
            },
            "description": "The care provider employee number (=KNummer). For all employed OKP care providers.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The careprovider (=Leistungserbringer)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyBusiness": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Party"
          }
        ],
        "properties": {
          "globalLocationNumber": {
            "type": "string",
            "nullable": true
          },
          "branch": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderBusinessParty": {
        "type": "object",
        "properties": {
          "party": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyBusiness"
              }
            ],
            "description": "The party (=Zahlstellen-Adresse)",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for a business party (=Personendaten). For each point in time only one active mapping should exist."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.FacilityType": {
        "enum": [
          "HOSPITAL_LAB_TYPE",
          "HOSPITAL_LAB_INFRASTRUCTURE",
          "FITNESS_CLASSIFICATION",
          "FITNESS_QUALITOP_FIT_SAFE",
          "DOCTOR_FACILITY",
          "HOSPITAL_FACILITY",
          "NURSING_HOME_FACILITY",
          "FITNESS_CARE_LEVEL"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Facility": {
        "type": "object",
        "properties": {
          "facilityType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.FacilityType"
              }
            ],
            "description": "The facility type.",
            "nullable": true
          },
          "facilityTypeTranslation": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "The facility name.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The business facility (=Einrichtung)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderBusinessFacility": {
        "type": "object",
        "properties": {
          "details": {
            "type": "string",
            "description": "Additional information for the assigned facility, e.g. bed count (=Anzahl Betten).",
            "nullable": true
          },
          "facility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Facility"
              }
            ],
            "description": "The facility (=Einrichtung).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for a business facilities (=Einrichtungen)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderBusiness": {
        "type": "object",
        "properties": {
          "comment": {
            "type": "string",
            "description": "An optional comment value.",
            "nullable": true
          },
          "isNotListedHospital": {
            "type": "boolean",
            "description": "The is not listed hospital flag (=Finanzierungsform)"
          },
          "careProvider": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProvider"
              }
            ],
            "description": "The care provider (=Leistungserbringer) managing the business (=Zahlstelle).",
            "nullable": true
          },
          "careProviderBusinessParties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderBusinessParty"
            },
            "description": "The business party (=Personendaten). Despite multiple records for each moment in time only one active party exists.",
            "nullable": true
          },
          "affiliatedCareProviderBusiness": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderBusiness"
              }
            ],
            "description": "Another busisness with a relation to this particular business.",
            "nullable": true
          },
          "facilities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderBusinessFacility"
            },
            "description": "A list of business facilities (=Einrichtung).",
            "nullable": true
          },
          "healthServices": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthServiceCertifier"
                },
                {
                  "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderHealthServiceHospital"
                }
              ],
              "description": "The mapping details for care provider health services (=Zertifizierer Methoden)."
            },
            "description": "A list of health services (=Zertifizierer Methoden) mapped to this particular business. For VVG businesses of complementary medicine only.",
            "nullable": true
          },
          "affiliations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderAffiliation"
            },
            "description": "A list of affiliations (=Mitgliedschaften) mapped to this particular business.",
            "nullable": true
          },
          "clearingNumbers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumber"
            },
            "description": "A list of clearing numbers (=ZSR-Nummern).",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The care provider business (=Zahlstelle)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyBeneficiary": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Party"
          }
        ],
        "properties": {
          "globalLocationNumber": {
            "type": "string",
            "nullable": true
          },
          "firm": {
            "type": "string",
            "nullable": true
          },
          "branch": {
            "type": "string",
            "nullable": true
          },
          "abbreviation": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.BankGroup": {
        "enum": [
          "SNB",
          "UBSAG",
          "RESERVE",
          "CREDIT_SUISSE_GROUP_AG_1",
          "CREDIT_SUISSE_GROUP_AG_2",
          "REGIONALBANKEN_RBA_HOLDING_AG",
          "KANTONALBANKEN",
          "RAIFFEISENBANKEN_EINZELINSTITUTE",
          "POST_FINANCE"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.BankClearingType": {
        "enum": [
          "HEAD_QUARTERS",
          "MAIN_BRANCH",
          "BRANCH"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Bank": {
        "type": "object",
        "properties": {
          "bankGroup": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.BankGroup"
              }
            ],
            "description": "The banks/financial institutions are divided into bank groups.",
            "nullable": true
          },
          "bankGroupTranslation": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "bankClearingType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.BankClearingType"
              }
            ],
            "description": "The bank type, e.g. head office, main branch or branch.",
            "nullable": true
          },
          "bankClearingTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "bankingClearingNumber": {
            "type": "string",
            "description": "Each bank/financial institution is identified by the BankingClearingNumber made up of 3 to 5 digits.",
            "nullable": true
          },
          "bankingClearingNumberNew": {
            "type": "string",
            "description": "Any value here replaces the BankingClearingNumber.",
            "nullable": true
          },
          "branchId": {
            "type": "string",
            "description": "Together with the BankingClearingNumber number the BranchId provides a conclusive key for each bank or financial institution record.",
            "nullable": true
          },
          "sicNumber": {
            "type": "string",
            "description": "A 6-digit number only to be used by SIC and euroSIC participants.",
            "nullable": true
          },
          "headquarterClearingNumber": {
            "type": "string",
            "description": "The BankingClearingNumber of the head office.",
            "nullable": true
          },
          "shortName": {
            "type": "string",
            "description": "The short name of the bank or financial institution.",
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "The name of the bank or financial institution",
            "nullable": true
          },
          "postalAccountNumber": {
            "type": "string",
            "description": "The bank's or financial institution's postal account number.",
            "nullable": true
          },
          "swift": {
            "type": "string",
            "description": "The SWIFT directory entry value.",
            "nullable": true
          },
          "contact": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Contact"
              }
            ],
            "description": "The bank's or financial institution's contact details.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The SIX bank details."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Account": {
        "type": "object",
        "properties": {
          "ibanNumber": {
            "type": "string",
            "description": "The IBAN number.",
            "nullable": true
          },
          "accountNumber": {
            "type": "string",
            "description": "The account number (=Kontonummer).",
            "nullable": true
          },
          "party": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.PartyBeneficiary"
              }
            ],
            "description": "Optionally contains the account holder (=Begünstigter) when not identical to the care provider (=Leistungserbringer).",
            "nullable": true
          },
          "bank": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Bank"
              }
            ],
            "description": "The account's bank.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The bank account."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberAccount": {
        "type": "object",
        "properties": {
          "account": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.Account"
              }
            ],
            "description": "The bank account.",
            "nullable": true
          },
          "hasPaymentOrderReferenceNumber": {
            "type": "boolean",
            "description": "Marks the current account mapping available for ESR payments.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for the clearing number bank account (=Konto)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberDummy": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The clearing number dummy name.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The clearing number dummy (=ZSR-Nummer)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.ClearingNumberRelationType": {
        "enum": [
          "CHANGE_OF_REGION",
          "CHANGE_OF_PRIMARY_BUSINESS_SCOPE",
          "MERGER",
          "TERMINATION_OF_ACTIVITY",
          "CHANGE_OF_ACTIVITY",
          "CHANGE_OF_HANDS",
          "SECOND_CLEARING_NUMBER_INCLUSIVE_SUSPENSIONS",
          "CHANGE_OF_SECONDARY_BUSINESS_SCOPE",
          "COMPLEMENTARY_CARE_PROVIDER_MERGER",
          "FITNESS_CARE_PROVIDER_MERGER",
          "INVALID_MAPPING",
          "MULTIPLE_LOCATIONS",
          "MAIN_CLEARING_NUMBER",
          "UNKNOWN"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberRelation": {
        "type": "object",
        "properties": {
          "clearingNumber": {
            "type": "string",
            "description": "The related clearing number.",
            "nullable": true
          },
          "isPublished": {
            "type": "boolean",
            "description": "The is active flag.",
            "nullable": true,
            "deprecated": true
          },
          "clearingNumberRelationType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.ClearingNumberRelationType"
              }
            ],
            "description": "The relation type (=Beziehungsart).",
            "nullable": true
          },
          "clearingNumberRelationTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for the clearing number relation (=Zugeordnete Zahlstellen, Zusätzliche Zahlstellen)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmployeeRelation": {
        "type": "object",
        "properties": {
          "employeeNumber": {
            "type": "string",
            "description": "The employee number (=KNummer).",
            "nullable": true
          },
          "isPublished": {
            "type": "boolean",
            "description": "The is active flag.",
            "nullable": true,
            "deprecated": true
          },
          "employmentType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.EmploymentType"
              }
            ],
            "description": "The employment type (=Anstellungstyp)",
            "nullable": true
          },
          "license": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.License"
              }
            ],
            "description": "The canton based license (=Zulassung).",
            "nullable": true
          },
          "employmentTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for the employee mapping (=Arbeitnehmer/Angestellte)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.TariffSystemType": {
        "enum": [
          "LOA",
          "NURSING_HOME_FLAT_RATE"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.TariffSystem": {
        "type": "object",
        "properties": {
          "tariffSystemType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.TariffSystemType"
              }
            ],
            "description": "The tariff system type.",
            "nullable": true
          },
          "tariffSystemTypeTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "The tariff name.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The tarif system."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberTariffSystem": {
        "type": "object",
        "properties": {
          "tariffSystem": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.TariffSystem"
              }
            ],
            "description": "The tarif system.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The mapping details for the tarifs system (=Tarif-Verträge, Spitallaboratorium etc.)."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberComment": {
        "type": "object",
        "properties": {
          "commentTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "description": "Comment translations.",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums)."
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The clearing number specific comment."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumber": {
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "description": "The clearing number (=ZSR-Nummer) as plain text value.",
            "nullable": true
          },
          "clearingNumberSuffix": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberSuffix"
              }
            ],
            "description": "The ClearingNumberSuffix (=StammKanton). This can be a swiss canton or any other regional entity.",
            "nullable": true
          },
          "clearingNumberCompensations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberCompensation"
            },
            "description": "The list of clearing number compensation types (=Entschädigungscode) valid for this clearing number.",
            "nullable": true
          },
          "clearingNumberLaws": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberLaw"
            },
            "description": "The list of clearing number law types (=Zulassung) applicable for this clearing number.",
            "nullable": true
          },
          "careProviderBusiness": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.CareProviderBusiness"
              }
            ],
            "description": "The care provider business (=Zahlstelle) this clearing number belongs to.",
            "nullable": true
          },
          "clearingNumberAccounts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberAccount"
            },
            "description": "The account mapping details (=Konto). Despite multiple records for each moment in time only one active account exists.",
            "nullable": true
          },
          "clearingNumberDummy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberDummy"
              }
            ],
            "description": "Marks the current clearing number as a special multi-purpose number, unrelated to any care provider.",
            "nullable": true
          },
          "businessScope": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.BusinessScope"
              }
            ],
            "description": "The business scope (=PartnerartObergruppe/-Untergruppe).",
            "nullable": true
          },
          "relatedClearingNumbers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberRelation"
            },
            "description": "A mapping list of related clearing numbers. For every related clearing number, the type of relation is specified.",
            "nullable": true
          },
          "relatedEmployees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmployeeRelation"
            },
            "description": "A mapping list of employees of the care provider business, this clearing number belongs to.",
            "nullable": true
          },
          "licenses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.License"
            },
            "description": "A list of licenses (=Zulassung KVG/VVG/UVG) provided to this clearing number.",
            "nullable": true
          },
          "tariffSystems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberTariffSystem"
            },
            "description": "A mapping list of tariff systems (=Tarif-Verträge).",
            "nullable": true
          },
          "comments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumberComment"
            },
            "description": "A list of comments regarding this clearing number.",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "The clearing number (=ZSR-Nummer) and its full context information. Every business of a care provider has a clearing number."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.ClearingNumberDetailViewItem": {
        "type": "object",
        "properties": {
          "modifiedTime": {
            "type": "string",
            "description": "Contains the clearing number modification date.",
            "format": "date-time"
          },
          "version": {
            "type": "string",
            "nullable": true
          },
          "clearingNumber": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.ClearingNumber"
              }
            ],
            "description": "Contains a complete data set of a single clearing number (=Zahlstelle).",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A container for one specific clearing number and its context information."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.EmployeeNumberDetailViewItem": {
        "type": "object",
        "properties": {
          "modifiedTime": {
            "type": "string",
            "description": "Contains the employee number modification date.",
            "format": "date-time"
          },
          "version": {
            "type": "string",
            "nullable": true
          },
          "employeeNumber": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.Contract.EmployeeNumber"
              }
            ],
            "description": "Contains a complete data set of a single employee number (=KNummer).",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A container for one specific employee number and its context information."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.HealthServiceCommentViewItem": {
        "type": "object",
        "properties": {
          "healthServiceId": {
            "type": "integer",
            "description": "The internal health service id.",
            "format": "int64"
          },
          "healthServiceExternalId": {
            "type": "string",
            "description": "The identification of the health service in the system of the API consumer as provided with the CareProviderCertification endpoint.",
            "nullable": true
          },
          "certifier": {
            "type": "string",
            "description": "The certifier name.",
            "nullable": true
          },
          "healthServiceTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "description": "The health service name in different languages.",
            "nullable": true
          },
          "commentTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "description": "The health service comment in different languages.",
            "nullable": true
          },
          "isExcluded": {
            "type": "boolean",
            "description": "Marks a health service as excluded/unsupported by an insurer."
          },
          "startDate": {
            "type": "string",
            "description": "Date of the validity start (=fachliches Startdatum). Time information will be ignored. Validity starts at the beginning of the specified day.",
            "format": "date-time",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "description": "Date of the validity end (=fachliches Enddatum). Time information will be ignored. Validity ends at the end of the specified day. If the period lasts indefinitely, the max date '9999-12-31 23:59:59.9999999' is used.",
            "format": "date-time",
            "nullable": true
          },
          "id": {
            "type": "integer",
            "description": "Unique identifier of the instance.",
            "format": "int64",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "One specific comment entry on a health service."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Requests.SearchOption": {
        "enum": [
          "Okp",
          "Ortho",
          "Pharma",
          "Lea",
          "Comp",
          "Fit",
          "Asca",
          "Spak",
          "Aptn",
          "Emr",
          "EmFit",
          "Qtop",
          "Fsafe",
          "FGuide",
          "FGuideK",
          "MedUnreg"
        ],
        "type": "string"
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.StringBulkResponse": {
        "type": "object",
        "properties": {
          "tookInMs": {
            "type": "integer",
            "description": "Request processing time in milliseconds.",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "description": "Overall, paging-independently count of entries according to the specified parameters.",
            "format": "int32"
          },
          "recordCount": {
            "type": "integer",
            "description": "Number of records in the current page.",
            "format": "int32",
            "readOnly": true
          },
          "offset": {
            "type": "integer",
            "description": "The applied offset value.",
            "format": "int32"
          },
          "limit": {
            "type": "integer",
            "description": "The applied limit value.",
            "format": "int32"
          },
          "records": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The records of the current page.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A response container for a list of string values."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.NumberListViewItem": {
        "type": "object",
        "properties": {
          "modifiedTime": {
            "type": "string",
            "description": "Contains the employee number modification date.",
            "format": "date-time"
          },
          "number": {
            "type": "string",
            "description": "The number (clearing or employee number) itself.",
            "nullable": true
          },
          "globalLocationNumber": {
            "type": "string",
            "description": "Global location number (=EANNummer).",
            "nullable": true
          },
          "organizationIdentificationNumber": {
            "type": "string",
            "description": "Organization identification number (=UID-Nummer/IDE/IDI).",
            "nullable": true
          },
          "firm": {
            "type": "string",
            "description": "The firm (=Firma).",
            "nullable": true
          },
          "branch": {
            "type": "string",
            "description": "The branch name (=Zweigstelle).",
            "nullable": true
          },
          "givenName": {
            "type": "string",
            "description": "Given name / first name (=Vorname).",
            "nullable": true
          },
          "callName": {
            "type": "string",
            "description": "Call name (=Rufname).",
            "nullable": true
          },
          "familyName": {
            "type": "string",
            "description": "Family name / last name (=Nachname).",
            "nullable": true
          },
          "originalName": {
            "type": "string",
            "description": "Orginal name (=Ledigenname).",
            "nullable": true
          },
          "postalCode": {
            "type": "string",
            "description": "The postal code, national and international (=PLZ).",
            "nullable": true
          },
          "place": {
            "type": "string",
            "description": "The place/city (=Ort).",
            "nullable": true
          },
          "street": {
            "type": "string",
            "description": "The street with street number (=Strasse).",
            "nullable": true
          },
          "phoneNumber": {
            "type": "string",
            "description": "An E.164 phone number.",
            "nullable": true
          },
          "isValid": {
            "type": "boolean",
            "description": "Is true, if the instance was valid at the requested validityDate. If no specific validityDate was specified, then the current date (now) is evaluated (=fachliche Gültigkeit zum Zeitpunkt des übergebenen Stichdatums).",
            "nullable": true
          },
          "detailViewItemUrl": {
            "type": "string",
            "description": "Resource URL to retrieve further details regarding this number.",
            "nullable": true
          },
          "clearingNumberSuffixTwoLetterCantonCode": {
            "type": "string",
            "nullable": true
          },
          "clearingNumberSuffixTranslations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Translation"
              }
            ],
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "A response container for a list of consolidated basic number (clearing or employee number) information."
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.AuthorizationAddress": {
        "type": "object",
        "properties": {
          "companyName": {
            "type": "string",
            "nullable": true
          },
          "additionalAdressData1": {
            "type": "string",
            "nullable": true
          },
          "additionalAdressData2": {
            "type": "string",
            "nullable": true
          },
          "street": {
            "type": "string",
            "nullable": true
          },
          "streetNumber": {
            "type": "string",
            "nullable": true
          },
          "zip": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "nullable": true
          },
          "phone2": {
            "type": "string",
            "nullable": true
          },
          "mobile": {
            "type": "string",
            "nullable": true
          },
          "fax": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "individualEnterpriseId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "individualEnterpriseText": {
            "type": "string",
            "nullable": true
          },
          "legalFormId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "legalFormIdText": {
            "type": "string",
            "nullable": true
          },
          "uidBusiness": {
            "type": "string",
            "nullable": true
          },
          "authorizationForSelfDispensationId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "authorizationForSelfDispensationText": {
            "type": "string",
            "nullable": true
          },
          "commentSelfDispensation": {
            "type": "string",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.ConditionsAndRestrictions": {
        "type": "object",
        "properties": {
          "typeId": {
            "type": "integer",
            "format": "int32"
          },
          "typeText": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "dateOfDecision": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfLimitation": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.Authorization": {
        "type": "object",
        "properties": {
          "addresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.AuthorizationAddress"
            },
            "nullable": true
          },
          "authorizationConditionsAndRestrictions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.ConditionsAndRestrictions"
            },
            "nullable": true
          },
          "cantonOfAuthorizationId": {
            "type": "integer",
            "format": "int32"
          },
          "cantonOfAuthorizationText": {
            "type": "string",
            "nullable": true
          },
          "legalBasisId": {
            "type": "integer",
            "format": "int32"
          },
          "legalBasisText": {
            "type": "string",
            "nullable": true
          },
          "statusOfAuthorizationId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "statusOfAuthorizationText": {
            "type": "string",
            "nullable": true
          },
          "dateOfDecision": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "activityId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "activityText": {
            "type": "string",
            "nullable": true
          },
          "dateOfDecisionActivity": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfLimitation": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "practiceOpeningDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "practiceClosingDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "authorizationHiaId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "authorizationHiaText": {
            "type": "string",
            "nullable": true
          },
          "authorizationForNarcoticsId": {
            "type": "integer",
            "format": "int32"
          },
          "authorizationForNarcoticsText": {
            "type": "string",
            "nullable": true
          },
          "commentNarcotics": {
            "type": "string",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.NinetyDayServiceProviderAddress": {
        "type": "object",
        "properties": {
          "companyName": {
            "type": "string",
            "nullable": true
          },
          "additionalAdressData1": {
            "type": "string",
            "nullable": true
          },
          "additionalAdressData2": {
            "type": "string",
            "nullable": true
          },
          "street": {
            "type": "string",
            "nullable": true
          },
          "streetNumber": {
            "type": "string",
            "nullable": true
          },
          "zip": {
            "type": "string",
            "nullable": true
          },
          "city": {
            "type": "string",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "nullable": true
          },
          "phone2": {
            "type": "string",
            "nullable": true
          },
          "mobile": {
            "type": "string",
            "nullable": true
          },
          "fax": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "authorizationForSelfDispensationId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "authorizationForSelfDispensationText": {
            "type": "string",
            "nullable": true
          },
          "commentSelfDispensation": {
            "type": "string",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.NinetyDayServiceProvider": {
        "type": "object",
        "properties": {
          "addresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.NinetyDayServiceProviderAddress"
            },
            "nullable": true
          },
          "statusId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "statusText": {
            "type": "string",
            "nullable": true
          },
          "dateOfNotification": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfStart": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfEnd": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "cantonOfAuthorizationId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "cantonOfAuthorizationText": {
            "type": "string",
            "nullable": true
          },
          "authorizationHiaId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "authorizationHiaText": {
            "type": "string",
            "nullable": true
          },
          "authorizationForNarcoticsId": {
            "type": "integer",
            "format": "int32"
          },
          "authorizationForNarcoticsText": {
            "type": "string",
            "nullable": true
          },
          "commentNarcotics": {
            "type": "string",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.Diploma": {
        "type": "object",
        "properties": {
          "authorizations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.Authorization"
            },
            "nullable": true
          },
          "ninetyDayServiceProviders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.NinetyDayServiceProvider"
            },
            "nullable": true
          },
          "diplomaId": {
            "type": "integer",
            "format": "int32"
          },
          "diplomaText": {
            "type": "string",
            "nullable": true
          },
          "typeOfDiplomaId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "typeOfDiplomaText": {
            "type": "string",
            "nullable": true
          },
          "dateOfIssue": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfRecognition": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfEquivalency": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "placeOfIssue": {
            "type": "string",
            "nullable": true
          },
          "landOfIssueId": {
            "type": "integer",
            "format": "int32"
          },
          "landOfIssueText": {
            "type": "string",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.PostgraduateTitle": {
        "type": "object",
        "properties": {
          "postgraduateTitleId": {
            "type": "integer",
            "format": "int32"
          },
          "postgraduateTitleText": {
            "type": "string",
            "nullable": true
          },
          "typeOfTitleId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "typeOfTitleText": {
            "type": "string",
            "nullable": true
          },
          "dateOfIssue": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfRecognition": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfEquivalency": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "placeOfIssue": {
            "type": "string",
            "nullable": true
          },
          "landOfIssueId": {
            "type": "integer",
            "format": "int32"
          },
          "landOfIssueText": {
            "type": "string",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.PrivateLawPostgraduateTitle": {
        "type": "object",
        "properties": {
          "typeId": {
            "type": "integer",
            "format": "int32"
          },
          "typeText": {
            "type": "string",
            "nullable": true
          },
          "designationId": {
            "type": "integer",
            "format": "int32"
          },
          "designationText": {
            "type": "string",
            "nullable": true
          },
          "dateOfIssue": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.LanguageAbility": {
        "type": "object",
        "properties": {
          "languageAbilityId": {
            "type": "integer",
            "format": "int32"
          },
          "languageAbilityText": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.Medical": {
        "type": "object",
        "properties": {
          "diplomas": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.Diploma"
            },
            "nullable": true
          },
          "postgraduateTitles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.PostgraduateTitle"
            },
            "nullable": true
          },
          "privateLawPostgraduateTitles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.PrivateLawPostgraduateTitle"
            },
            "nullable": true
          },
          "languageAbilities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sasis.Register.CareProvider.Common.Models.ApiGateway.V1.Responses.MedReg.LanguageAbility"
            },
            "nullable": true
          },
          "gln": {
            "type": "string",
            "nullable": true
          },
          "uid": {
            "type": "string",
            "nullable": true
          },
          "firstName": {
            "type": "string",
            "nullable": true
          },
          "lastName": {
            "type": "string",
            "nullable": true
          },
          "previousName": {
            "type": "string",
            "nullable": true
          },
          "dateOfBirth": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "sexId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "sexText": {
            "type": "string",
            "nullable": true
          },
          "languageId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "languageText": {
            "type": "string",
            "nullable": true
          },
          "placeOfOrigin": {
            "type": "string",
            "nullable": true
          },
          "nationalityId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "nationalityText": {
            "type": "string",
            "nullable": true
          },
          "nationality2Id": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "nationality2Text": {
            "type": "string",
            "nullable": true
          },
          "dateOfMutation": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "description": "JWT Authorization header using the Bearer scheme. Example:\"Authorization:Bearer {token}\"",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "Bearer": [ ]
    }
  ]
}




Status codes

The SASIS Register API uses standard http status codes.

The following status codes will generally be used by the API: 

Status CodeDescription
200Success
202Accepted; Request is valid and business process could be triggered successfully.
400Bad Request; The request data is invalid.
401Unauthorized; The caller does not have sufficient privileges to perform the call.
403Forbidden;  The server is refusing the action.
500Internal Server Error; Any unexpected internal failure.


Referenced Algorithms

Clearing number check digit

Panel

The clearing number has the following structure:

  • A leading char as check digit
  • A four digit sequential number
  • A two digit number circle / canton number

The leading char of the clearing number is created and validated as follows:

  • Each number is multiplied with its position (calculate from the right end).
  • All products are summarized into one sum.
  • Modulo 26 of the sum denotes the char in the alphabet (result 0 results in char 'Z'). 

Example L248519:
(9*1)+(1*2)+(5*3)+(8*4)+(4*5)+(2*6) = 90
90 mod 26 = 12
12th char in the alphabet = L


UID ECH0097 check digit

Panel

The ECH0097 enterprise identification number (Unternehmensidentifikationsnummer UID, Numéro d’identification des entreprises IDE, Numero d’identificazione delle imprese IDI) has the following structure:

  • ISO-Alpha-3 Code (ISO 3166-1) of Switzerland (CHE)
  • 8 digit pseudo random number
  • check digit

The check digit is created and validated as follows:

  • Each digit of the pseudo-random number is multiplied with a predefined multiplier: 54327654
  • All products are summarized into one sum.
  • 11 minus Modulo 11 of the sum defines the check digit.

Example CHE-114.617.288:
(1*5)+(1*4)+(4*3)+(6*2)+(1*7)+(7*6)+(2*5)+(8*4) = 124
124 mod 11 = 3
11 - 3 = 8


Authentication / Autorisation

The authentication is based on OpenID Connect, an identity layer on top of OAuth 2.0 and its corresponding flows/grants. For application integration, the resource owner password flow using the OAuth 2.0 password grant is to be used. 

The SASIS IAM infrastructure acts a OpenID provider / authorization server.

draw.io Diagram
bordertrue
viewerToolbartrue
fitWindowfalse
diagramNameapi_access_sequence
simpleViewerfalse
width600
diagramWidth676
revision2

  1. The API Client requests the token endpoint from the auth server.
  2. The token endpoint is returned to the API Client.
  3. Request an access token from the auth server by providing the following post request parameters:
    1. grant_type: set to 'password'
    2. client_id: provided individually by SASIS
    3. client_secret: provided individually by SASIS
    4. username: provided individually by SASIS
    5. password: provided individually by SASIS
    6. scope: set constantly to 'openid profile email offline_access roles c1s_profile cpr'
  4. The access token as well as the refresh token is returned to the API Client.
  5. The specific API resource is called providing the access token in as bearer in the Authorization http header:
    'Authorization: Bearer <access token>'
  6. The API responds to the request.
  7. Once the access token expired, the previously received refresh token is used to request a new access token from the auth server by providing the following parameters:
    1. grant_type: set to 'refresh_token'
    2. client_id: provided individually by SASIS
    3. client_secret: provided individually by SASIS
    4. scope: set constantly to 'openid profile email offline_access roles c1s_profile cpr'
    5. refresh_token: The refresh token received with the last access token.
  8. A new access token as well as a new refresh token is returned to the API Client.
  9. The specific API resource is called providing the new access token in as bearer in the Authorization http header:
    'Authorization: Bearer <access token>'
  10. The API responds to the request.

Access token

The access token response contains additional information:

Code Block
languagejava
titleAccess token response
{
  "access_token": "MTQ0NjOkZmQ5OTM5NDE9ZTZjNGZmZjI3",
  "refresh_token": "GEbRxBNZmQOTM0NjOkZ5NDE9ZedjnXbL",
  "token_type": "bearer",
  "expires_in": 300,
  "scope": "openid profile email offline_access roles c1s_profile cpr"
}

The token itself is a JWT and can therefore be decoded on the JWT website.

The expires_in field defines the validity period of the token in seconds. Afterwards, a new token must be retrieved.

Code samples

A complete c# sample shows how to access one specific API resource (numbers): 

HTML
<div class="references">

CprApiAccessSample.zip

HTML
</div>

Authentication in other languages follows the same procedure.

The following code snippets explain the procedure on a step-by-step basis:

Code Block
languagec#
themeConfluence
title1./2. Retrieve the auth servers token endpoint
collapsetrue
        /// <summary>
        /// Loads the IAM configuration.
        /// </summary>
        private async Task<DiscoveryResponse> GetDiscoveryDocumentAsync(CancellationToken ct)
        {
            using (var client = new HttpClient())
            {
                var discoveryResponse = await client.GetDiscoveryDocumentAsync(new DiscoveryDocumentRequest
                {
                    Address = "[AuthorityUrl]"
                }, ct).ConfigureAwait(false);

                if (discoveryResponse.IsError)
                    throw new Exception(discoveryResponse.Error);

                return discoveryResponse;
            }
        }

Code Block
languagec#
themeConfluence
title3./4. Request access and refresh token
collapsetrue
        /// <summary>
        /// Gets a new token response with a username and password.
        /// </summary>
        private async Task<TokenResponse> RequestTokenAsync(CancellationToken ct)
        {
            using (var client = new HttpClient())
            {
                var discoveryResponse = await GetDiscoveryDocumentAsync(ct).ConfigureAwait(false);

                var tokenResponse = await client.RequestPasswordTokenAsync(new PasswordTokenRequest
                {
                    ClientId = "[ClientId]",
                    ClientSecret = "[ClientSecret]",
                    UserName = "[UserName]",
                    Password = "[Password]",
                    Address = discoveryResponse.TokenEndpoint,
                    GrantType = OidcConstants.GrantTypes.Password,
                    Scope = string.Join(" ", _scopes),
                }, ct).ConfigureAwait(false);

                if (tokenResponse.IsError)
                    throw new Exception(tokenResponse.Error);

                return tokenResponse;
            }
        }

Code Block
languagec#
themeConfluence
title7./8. Token refresh strategy based validity of cached token response and request new access token
collapsetrue
        /// <summary>
        /// Gets the access token by either requesting a new token or by using the refresh token of an already existing token.
        /// </summary>
        private async Task<string> GetAccessTokenAsync(CancellationToken ct)
        {
            if (_tokenResponse == null)
            {
                // Creates a new token response
                _tokenResponse = await RequestTokenAsync(ct).ConfigureAwait(false);
            }
            else
            {
                var jwtSecurityTokenHandler = new JwtSecurityTokenHandler();

                // Parses JWT access token
                var jwtSecurityToken = jwtSecurityTokenHandler.ReadToken(_tokenResponse.AccessToken) as JwtSecurityToken;

                // The access token might be valid now, but expired the very next millisecond.
                // Thus, add a reasonable reserve in minutes for the validity time comparison below.
                var comparisionCorrectionInMinutes = 1;

                // Compares the access token life time with the current time, modified by the comparison correction value.
                if (jwtSecurityToken.ValidTo < DateTime.UtcNow.AddMinutes(comparisionCorrectionInMinutes))
                {
                    // Updates the existing token response
                    _tokenResponse = await RefreshTokenAsync(_tokenResponse.RefreshToken, ct).ConfigureAwait(false);
                }
            }

            return _tokenResponse.AccessToken;
        }

        /// <summary>
        /// Gets an updated token response by using a refresh token.
        /// </summary>
        private async Task<TokenResponse> RefreshTokenAsync(string refreshToken, CancellationToken ct)
        {
            using (var client = new HttpClient())
            {
                var discoveryResponse = await GetDiscoveryDocumentAsync(ct).ConfigureAwait(false);

                var tokenResponse = await client.RequestTokenAsync(new TokenRequest
                {
                    ClientId = "[ClientId]",
                    ClientSecret = "[ClientSecret]",
                    Address = discoveryResponse.TokenEndpoint,
                    ClientCredentialStyle = ClientCredentialStyle.AuthorizationHeader,
                    GrantType = OidcConstants.GrantTypes.RefreshToken,
                    Parameters =
                    {
                        { "refresh_token", refreshToken },
                        { "scope", string.Join(" ", _scopes) }
                    }
                });

                if (tokenResponse.IsError)
                    throw new Exception(tokenResponse.Error);

                return tokenResponse;
            }
        }


Code Block
languagec#
themeConfluence
title5./6./9./10. API resource call using the access token in the Authorization http header
collapsetrue
        /// <summary>
        /// A simple CPR API number search request.
        /// </summary>
        private async Task<BulkResponse> CprApiSampleRequestAsync(string accessToken, CancellationToken ct)
        {
            BulkResponse bulkResponse = new BulkResponse();

            using (var client = new HttpClient())
            {
                client.SetBearerToken(accessToken);

                var response = await client.GetAsync($"https://[CprBaseUrl]/ApiGateway/api/v1/numbers?searchOptions=Okp&offset=0&limit=10", ct).ConfigureAwait(false);

                if (!response.IsSuccessStatusCode)
                    throw new Exception("There was a problem with the request");

                string content = await response.Content.ReadAsStringAsync();

                if (content != null && content.Length > 0)
                {
                    bulkResponse = JsonConvert.DeserializeObject<BulkResponse>(content);
                }
            }

            return bulkResponse;
        }

Code Block
languagec#
themeConfluence
titlePlain API Call (putting everything together)
collapsetrue
        var accessToken = await GetAccessTokenAsync(ct).ConfigureAwait(false);

        var cprApiResponse = await CprApiSampleRequestAsync(accessToken, ct).ConfigureAwait(false);

Connection Settings

SettingTest EnvironmentLive Environment
AuthorityUrlhttps://sasopenid-authtest.itsensesantesuisse.chhttps://openid.santesuisse.com
CprBaseUrlhttps://stagecurrent.zsrnext.ch/https://www.zsrnext.ch
ClientId1)1)
ClientSecret1)1)
UserName1)1)
Password1)1)

1) To be provided individually by SASIS. Please contact: support@sasis.ch

...