Suomi.fi · Schema

ChannelResponse

Channel response

GovernmentFinlandPublic SectorDigital IdentityService CatalogueOpen DataX-Road
View JSON Schema on GitHub

JSON Schema

suomi-fi-channel-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/suomi-fi/json-schema/suomi-fi-channel-response-schema.json",
  "title": "ChannelResponse",
  "description": "Channel response",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/suomi-fi-ptv-openapi.yml#/components/schemas/ChannelResponse",
  "type": "object",
  "required": [
    "serviceChannelType"
  ],
  "oneOf": [
    {
      "$ref": "#/$defs/EServiceChannelResponse"
    },
    {
      "$ref": "#/$defs/PhoneChannelResponse"
    },
    {
      "$ref": "#/$defs/PrintableFormChannelResponse"
    },
    {
      "$ref": "#/$defs/ServiceLocationChannelResponse"
    },
    {
      "$ref": "#/$defs/WebPageChannelResponse"
    }
  ],
  "$defs": {
    "AccessibilityClassificationLevel": {
      "description": "Accessibility classification level",
      "enum": [
        "FullyCompliant",
        "PartiallyCompliant",
        "NonCompliant",
        "Unknown"
      ],
      "type": "string",
      "title": "AccessibilityClassificationLevel"
    },
    "AddressSourceResponse": {
      "description": "Address source response",
      "type": "object",
      "required": [
        "source"
      ],
      "oneOf": [
        {
          "$ref": "#/$defs/UserEnteredAddressSourceResponse"
        },
        {
          "$ref": "#/$defs/PostiAddressSourceResponse"
        }
      ],
      "title": "AddressSourceResponse"
    },
    "AllowedConnectionType": {
      "description": "Allowed connection type",
      "enum": [
        "AllOrganizations",
        "OwnOrganizations"
      ],
      "type": "string",
      "title": "AllowedConnectionType"
    },
    "AreaTypesResponse": {
      "description": "One of area types",
      "type": "object",
      "required": [
        "areaType"
      ],
      "oneOf": [
        {
          "$ref": "#/$defs/WholeCountry"
        },
        {
          "$ref": "#/$defs/WholeCountryExceptAland"
        },
        {
          "$ref": "#/$defs/LimitedArea"
        }
      ],
      "title": "AreaTypesResponse"
    },
    "ClosedExceptionalWeekdayHourResponse": {
      "type": "object",
      "required": [
        "openingStatus",
        "repetition",
        "additionalInformation"
      ],
      "properties": {
        "openingStatus": {
          "type": "string",
          "enum": [
            "Closed"
          ]
        },
        "repetition": {
          "$ref": "#/$defs/WeeklyRepetitionType"
        },
        "additionalInformation": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        }
      },
      "description": "Closed exceptional weekday hour. A closed hour has no start or end time.",
      "title": "ClosedExceptionalWeekdayHourResponse"
    },
    "ContactMethodPriority": {
      "description": "Contact method priority",
      "enum": [
        "FaxNumber",
        "PostalAddress",
        "PhoneNumber",
        "Email",
        "WebSite"
      ],
      "type": "string",
      "title": "ContactMethodPriority"
    },
    "ContactMethodPriorityResponseSchema": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ContactMethodPriority"
      },
      "description": "Contact method priority response",
      "title": "ContactMethodPriorityResponseSchema"
    },
    "ContentIdType": {
      "type": "string",
      "format": "uuid",
      "description": "Content id type",
      "title": "ContentIdType"
    },
    "ContinuousAlwaysValidServiceHourResponse": {
      "type": "object",
      "required": [
        "type",
        "openingStatus",
        "heading",
        "additionalInformation"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "ContinuousAlwaysValidServiceHour"
          ]
        },
        "openingStatus": {
          "$ref": "#/$defs/OpeningStatusType"
        },
        "heading": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "additionalInformation": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        }
      },
      "description": "Continuous always valid service hour",
      "title": "ContinuousAlwaysValidServiceHour"
    },
    "ContinuousDateRangeServiceHourResponse": {
      "type": "object",
      "required": [
        "type",
        "openingStatus",
        "heading",
        "additionalInformation",
        "fromDate",
        "toDate",
        "fromTime",
        "toTime",
        "fromDay",
        "toDay"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "ContinuousDateRangeServiceHour"
          ]
        },
        "openingStatus": {
          "$ref": "#/$defs/OpeningStatusType"
        },
        "heading": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "additionalInformation": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "fromDate": {
          "type": "string",
          "title": "iso-date",
          "description": "Date in ISO 8601 format YYYY-MM-DD e.g. 2026-01-15",
          "format": "date"
        },
        "toDate": {
          "type": "string",
          "title": "iso-date",
          "description": "Date in ISO 8601 format YYYY-MM-DD e.g. 2026-01-15",
          "format": "date"
        },
        "fromTime": {
          "type": "string",
          "title": "iso-time",
          "description": "Time in ISO 8601 format hh:mm e.g. 17:59"
        },
        "toTime": {
          "type": "string",
          "title": "iso-time",
          "description": "Time in ISO 8601 format hh:mm e.g. 17:59"
        },
        "fromDay": {
          "$ref": "#/$defs/WeekdayNamesType"
        },
        "toDay": {
          "$ref": "#/$defs/WeekdayNamesType"
        }
      },
      "description": "Continuous date range service hour",
      "additionalProperties": false,
      "title": "ContinuousDateRangeServiceHour"
    },
    "ContinuousWeekdaysUntilFurtherNoticeServiceHourResponse": {
      "type": "object",
      "required": [
        "type",
        "openingStatus",
        "heading",
        "additionalInformation",
        "fromDay",
        "toDay",
        "fromTime",
        "toTime"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "ContinuousWeekdaysUntilFurtherNoticeServiceHour"
          ]
        },
        "openingStatus": {
          "$ref": "#/$defs/OpeningStatusType"
        },
        "heading": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "additionalInformation": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "fromDay": {
          "$ref": "#/$defs/WeekdayNamesType"
        },
        "toDay": {
          "$ref": "#/$defs/WeekdayNamesType"
        },
        "fromTime": {
          "type": "string",
          "title": "iso-time",
          "description": "Time in ISO 8601 format hh:mm e.g. 17:59"
        },
        "toTime": {
          "type": "string",
          "title": "iso-time",
          "description": "Time in ISO 8601 format hh:mm e.g. 17:59"
        }
      },
      "description": "Continuous weekdays until further notice service hour",
      "additionalProperties": false,
      "title": "ContinuousWeekdaysUntilFurtherNoticeServiceHour"
    },
    "CoordinateResponse": {
      "type": "object",
      "required": [
        "system",
        "source",
        "easting",
        "northing"
      ],
      "properties": {
        "system": {
          "enum": [
            "EPSG:3067",
            "Unknown"
          ],
          "type": "string"
        },
        "source": {
          "enum": [
            "NLS",
            "User",
            "AccessibilityRegister"
          ],
          "type": "string"
        },
        "easting": {
          "type": "number"
        },
        "northing": {
          "type": "number"
        }
      },
      "description": "Coordinate",
      "title": "CoordinateResponse"
    },
    "DateTime": {
      "type": "string",
      "format": "date-time",
      "description": "string, e.g. 2025-09-22T07:32:52.026Z",
      "title": "DateTime"
    },
    "DeliveryAddress": {
      "description": "Delivery address",
      "type": "object",
      "required": [
        "deliveryAddressType"
      ],
      "oneOf": [
        {
          "$ref": "#/$defs/StreetAddressDeliveryAddress"
        },
        {
          "$ref": "#/$defs/PostOfficeBoxDeliveryAddress"
        },
        {
          "$ref": "#/$defs/DeliveryInformationDeliveryAddress"
        }
      ],
      "title": "DeliveryAddress"
    },
    "DeliveryInformationDeliveryAddress": {
      "type": "object",
      "required": [
        "recipient",
        "deliveryInformation",
        "deliveryAddressType"
      ],
      "properties": {
        "recipient": {
          "type": "object",
          "properties": {
            "fi": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "sv": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "en": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "se": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "smn": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "sms": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "additionalProperties": false
        },
        "deliveryInformation": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "deliveryAddressType": {
          "type": "string",
          "description": "Delivery information delivery address type",
          "title": "PrintableFormDeliveryInformationType",
          "enum": [
            "DeliveryInformation"
          ]
        }
      },
      "description": "Delivery information delivery address",
      "additionalProperties": false,
      "title": "DeliveryInformationDeliveryAddress"
    },
    "DomesticPhoneNumberResponse": {
      "type": "object",
      "required": [
        "additionalInformation",
        "chargeDescription",
        "chargeType",
        "number",
        "type"
      ],
      "properties": {
        "additionalInformation": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "chargeDescription": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "chargeType": {
          "$ref": "#/$defs/PhoneChargeType"
        },
        "number": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "DomesticPhone"
          ]
        }
      },
      "description": "Domestic phone number",
      "additionalProperties": false,
      "title": "DomesticPhoneNumberResponse"
    },
    "EServiceChannelLanguageVersionResponse": {
      "type": "object",
      "required": [
        "name",
        "summary",
        "description",
        "accessibilityClassificationLevel",
        "webAddress",
        "attachmentLinks",
        "supportEmails",
        "supportPhoneNumbers"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "summary": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string",
              "description": "Markdown-formatted content. Use a Markdown parser/renderer when presenting it."
            },
            {
              "type": "null"
            }
          ]
        },
        "accessibilityClassificationLevel": {
          "$ref": "#/$defs/AccessibilityClassificationLevel"
        },
        "webAddress": {
          "$ref": "#/$defs/WebAddressNameResponse"
        },
        "attachmentLinks": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/WebPageWithAdditionalInformationResponse"
          }
        },
        "supportEmails": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/EmailResponse"
          }
        },
        "supportPhoneNumbers": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/TelephoneNumberResponse"
          }
        }
      },
      "description": "EService channel language version response",
      "additionalProperties": false,
      "title": "EServiceChannelLanguageVersionResponse"
    },
    "EServiceChannelLanguageVersionsResponse": {
      "type": "object",
      "properties": {
        "fi": {
          "$ref": "#/$defs/EServiceChannelLanguageVersionResponse"
        },
        "sv": {
          "$ref": "#/$defs/EServiceChannelLanguageVersionResponse"
        },
        "en": {
          "$ref": "#/$defs/EServiceChannelLanguageVersionResponse"
        },
        "se": {
          "$ref": "#/$defs/EServiceChannelLanguageVersionResponse"
        },
        "smn": {
          "$ref": "#/$defs/EServiceChannelLanguageVersionResponse"
        },
        "sms": {
          "$ref": "#/$defs/EServiceChannelLanguageVersionResponse"
        }
      },
      "additionalProperties": false,
      "description": "EService channel language versions response",
      "title": "EServiceChannelLanguageVersionsResponse"
    },
    "EServiceChannelResponse": {
      "type": "object",
      "required": [
        "contentId",
        "organizationContentId",
        "allowedConnectionType",
        "serviceLanguages",
        "area",
        "publishedAt",
        "serviceChannelType",
        "languageVersions",
        "electronicSignature",
        "electronicIdentification",
        "serviceHours",
        "supportContactMethodPriority"
      ],
      "properties": {
        "migratedAt": {
          "anyOf": [
            {
              "$ref": "#/$defs/DateTime"
            },
            {
              "type": "null"
            }
          ]
        },
        "contentId": {
          "$ref": "#/$defs/ContentIdType"
        },
        "organizationContentId": {
          "$ref": "#/$defs/ContentIdType"
        },
        "allowedConnectionType": {
          "$ref": "#/$defs/AllowedConnectionType"
        },
        "serviceLanguages": {
          "$ref": "#/$defs/ServiceLanguages"
        },
        "area": {
          "anyOf": [
            {
              "$ref": "#/$defs/AreaTypesResponse"
            },
            {
              "type": "null"
            }
          ]
        },
        "publishedAt": {
          "anyOf": [
            {
              "$ref": "#/$defs/DateTime"
            },
            {
              "type": "null"
            }
          ]
        },
        "serviceChannelType": {
          "$ref": "#/$defs/EServiceChannelType"
        },
        "languageVersions": {
          "$ref": "#/$defs/EServiceChannelLanguageVersionsResponse"
        },
        "electronicSignature": {
          "$ref": "#/$defs/Signature"
        },
        "electronicIdentification": {
          "$ref": "#/$defs/ElectronicIdentification"
        },
        "serviceHours": {
          "$ref": "#/$defs/ServiceHoursResponse"
        },
        "supportContactMethodPriority": {
          "$ref": "#/$defs/SupportContactMethodPriorityResponse"
        }
      },
      "title": "EService",
      "description": "EService channel response"
    },
    "EServiceChannelType": {
      "type": "string",
      "description": "EService channel type",
      "title": "EServiceChannelType",
      "enum": [
        "EService"
      ]
    },
    "ElectronicIdentification": {
      "description": "Electronic identification",
      "enum": [
        "Required",
        "NotRequired"
      ],
      "type": "string",
      "title": "ElectronicIdentification"
    },
    "EmailResponse": {
      "type": "object",
      "required": [
        "email"
      ],
      "properties": {
        "email": {
          "type": "string"
        }
      },
      "title": "EmailResponse"
    },
    "ExceptionalDateRangeServiceHourResponse": {
      "type": "object",
      "required": [
        "type",
        "heading",
        "additionalInformation",
        "fromDate",
        "toDate",
        "weeklyHours"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "ExceptionalDateRangeServiceHour"
          ]
        },
        "heading": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "additionalInformation": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "fromDate": {
          "type": "string",
          "title": "iso-date",
          "description": "Date in ISO 8601 format YYYY-MM-DD e.g. 2026-01-15",
          "format": "date"
        },
        "toDate": {
          "type": "string",
          "title": "iso-date",
          "description": "Date in ISO 8601 format YYYY-MM-DD e.g. 2026-01-15",
          "format": "date"
        },
        "weeklyHours": {
          "$ref": "#/$defs/PartialExceptionalWeekResponse"
        }
      },
      "description": "Exceptional date range service hour",
      "additionalProperties": false,
      "title": "ExceptionalDateRangeServiceHour"
    },
    "ExceptionalServiceHourOpeningStatusType": {
      "description": "Opening status",
      "enum": [
        "Open",
        "Closed",
        "OpenOnReservation"
      ],
      "type": "string",
      "title": "ExceptionalServiceHourOpeningStatusType"
    },
    "ExceptionalWeekdayHourTypeResponse": {
      "type": "object",
      "required": [
        "openingStatus"
      ],
      "description": "Exceptional weekday hour",
      "oneOf": [
        {
          "$ref": "#/$defs/OpenExceptionalWeekdayHourResponse"
        },
        {
          "$ref": "#/$defs/ClosedExceptionalWeekdayHourResponse"
        }
      ],
      "title": "ExceptionalWeekdayHourTypeResponse"
    },
    "ExceptionalWeekdayTypeResponse": {
      "type": "object",
      "required": [
        "hours"
      ],
      "properties": {
        "hours": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ExceptionalWeekdayHourTypeResponse"
          }
        }
      },
      "description": "Exceptional weekday",
      "title": "ExceptionalWeekdayTypeResponse"
    },
    "FaxNumberResponse": {
      "type": "object",
      "required": [
        "dialCode",
        "additionalInformation",
        "chargeDescription",
        "chargeType",
        "number",
        "type"
      ],
      "properties": {
        "dialCode": {
          "type": "string"
        },
        "additionalInformation": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "chargeDescription": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "chargeType": {
          "$ref": "#/$defs/PhoneChargeType"
        },
        "number": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "Fax"
          ]
        }
      },
      "description": "Fax number",
      "additionalProperties": false,
      "title": "FaxNumberResponse"
    },
    "ForeignAddressResponse": {
      "type": "object",
      "required": [
        "address",
        "countryCode"
      ],
      "properties": {
        "address": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "countryCode": {
          "type": "string"
        }
      },
      "description": "Foreign address",
      "title": "ForeignAddressResponse"
    },
    "HolidayHourTypeResponse": {
      "type": "object",
      "required": [
        "start",
        "end",
        "openingStatus",
        "additionalInformation"
      ],
      "properties": {
        "start": {
          "type": "string",
          "title": "iso-time",
          "description": "Time in ISO 8601 format hh:mm e.g. 17:59"
        },
        "end": {
          "type": "string",
          "title": "iso-time",
          "description": "Time in ISO 8601 format hh:mm e.g. 17:59"
        },
        "openingStatus": {
          "$ref": "#/$defs/ExceptionalServiceHourOpeningStatusType"
        },
        "additionalInformation": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        }
      },
      "description": "Holiday hour",
      "title": "HolidayHourTypeResponse"
    },
    "HolidayResponse": {
      "type": "object",
      "required": [
        "holidayName",
        "hours"
      ],
      "properties": {
        "holidayName": {
          "enum": [
            "NewYearEve",
            "NewYearDay",
            "Epiphany",
            "MaundyThursday",
            "GoodFriday",
            "EasterSunday",
            "EasterMonday",
            "MayDayEve",
            "MayDay",
            "AscensionDay",
            "WhitSunday",
            "MidsummerEve",
            "MidsummerDay",
            "AllSaintsDay",
            "IndependenceDay",
            "ChristmasEve",
            "ChristmasDay",
            "SecondDayOfChristmas"
          ],
          "type": "string"
        },
        "hours": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/HolidayHourTypeResponse"
          }
        }
      },
      "description": "Holiday. Use a third-party date library to resolve the calendar date for movable holidays, such as Easter Sunday.",
      "title": "HolidayResponse"
    },
    "HolidayServiceHourTypeResponse": {
      "type": "object",
      "required": [
        "repetition",
        "holidays"
      ],
      "properties": {
        "repetition": {
          "$ref": "#/$defs/RepetitionTypeResponse"
        },
        "holidays": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/HolidayResponse"
          }
        }
      },
      "additionalProperties": false,
      "description": "Holiday service hour",
      "title": "HolidayServiceHourTypeResponse"
    },
    "InternationalPhoneNumberResponse": {
      "type": "object",
      "required": [
        "dialCode",
        "additionalInformation",
        "chargeDescription",
        "chargeType",
        "number",
        "type"
      ],
      "properties": {
        "dialCode": {
          "type": "string"
        },
        "additionalInformation": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "chargeDescription": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "chargeType": {
          "$ref": "#/$defs/PhoneChargeType"
        },
        "number": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "InternationalPhone"
          ]
        }
      },
      "description": "International phone number",
      "additionalProperties": false,
      "title": "InternationalPhoneNumberResponse"
    },
    "LimitedArea": {
      "type": "object",
      "required": [
        "areaType",
        "municipalities",
        "regions",
        "wellbeingServicesCounties"
      ],
      "properties": {
        "areaType": {
          "type": "string",
          "title": "LimitedArea",
          "enum": [
            "LimitedArea"
          ]
        },
        "municipalities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "regions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "wellbeingServicesCounties": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "title": "LimitedArea",
      "description": "Limited area"
    },
    "NormalServiceHoursTypeResponse": {
      "type": "object",
      "required": [
        "type"
      ],
      "description": "Service hours",
      "oneOf": [
        {
          "$ref": "#/$defs/WeeklyUntilFurtherNoticeServiceHour"
        },
        {
          "$ref": "#/$defs/WeeklyDateRangeServiceHourResponse"
        },
        {
          "$ref": "#/$defs/ContinuousAlwaysValidServiceHourResponse"
        },
        {
          "$ref": "#/$defs/ContinuousDateRangeServiceHourResponse"
        },
        {
          "$ref": "#/$defs/ContinuousWeekdaysUntilFurtherNoticeServiceHourResponse"
        },
        {
          "$ref": "#/$defs/ExceptionalDateRangeServiceHourResponse"
        }
      ],
      "title": "NormalServiceHoursTypeResponse"
    },
    "OpenExceptionalWeekdayHourResponse": {
      "type": "object",
      "required": [
        "start",
        "end",
        "openingStatus",
        "repetition",
        "additionalInformation"
      ],
      "properties": {
        "start": {
          "type": "string",
          "title": "iso-time",
          "description": "Time in ISO 8601 format hh:mm e.g. 17:59"
        },
        "end": {
          "type": "string",
          "title": "iso-time",
          "description": "Time in ISO 8601 format hh:mm e.g. 17:59"
        },
        "openingStatus": {
          "enum": [
            "Open",
            "OpenOnReservation"
          ],
          "type": "string"
        },
        "repetition": {
          "$ref": "#/$defs/WeeklyRepetitionType"
        },
        "additionalInformation": {
          "type": "object",
          "properties": {
            "fi": {
              "type": "string"
            },
            "sv": {
              "type": "string"
            },
            "en": {
              "type": "string"
            },
            "se": {
              "type": "string"
            },
            "smn": {
              "type": "string"
            },
            "sms": {
              "type": "string"
            }
          },
          "additionalProperties": false
        }
      },
      "description": "Open exceptional weekday hour",
      "titl

# --- truncated at 32 KB (84 KB total) ---
# Full source: https://artifacts.apis.io/suomi-fi/json-schema/suomi-fi-channel-response-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/suomi-fi-channel-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.