events_schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Events",
  "type": "object",
  "required": [
    "events"
  ],
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "$ref": "#/definitions/Event"
      }
    }
  },
  "additionalProperties": false,
  "definitions": {
    "DanceStyle": {
      "type": "string",
      "enum": [
        "balfolk",
        "contra",
        "e-ceilidh",
        "ceili",
        "irish-set",
        "italian",
        "ecd",
        "polish",
        "reeling",
        "s-ceilidh",
        "scd",
        "scandi"
      ]
    },
    "Event": {
      "type": "object",
      "required": [
        "city",
        "country",
        "name"
      ],
      "properties": {
        "bands": {
          "description": "The names of the bands playing at the event.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "callers": {
          "description": "The names of the callers calling at the event, if applicable.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "cancelled": {
          "description": "Whether the event has been cancelled.",
          "type": "boolean"
        },
        "city": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "details": {
          "description": "More details describing the event.",
          "type": [
            "string",
            "null"
          ]
        },
        "end_date": {
          "description": "The last day of the event, in the local timezone. Events which finish some hours after midnight should be considered to finish the day before.",
          "type": "string",
          "format": "date"
        },
        "links": {
          "description": "URLs with more information about the event, including the Facebook event page if any.",
          "default": [],
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "end": {
          "type": "string",
          "format": "date-time"
        },
        "start":  {
          "type": "string",
          "format": "date-time"
        },
        "name": {
          "description": "The name of the event.",
          "type": "string"
        },
        "organisation": {
          "description": "The organisation who run the event.",
          "default": null,
          "type": [
            "string",
            "null"
          ]
        },
        "price": {
          "description": "The price or price range of the event, if available.",
          "type": [
            "string",
            "null"
          ]
        },
        "social": {
          "description": "The event includes one or more social dances.",
          "default": false,
          "type": "boolean"
        },
        "start_date": {
          "description": "The first day of the event, in the local timezone.",
          "type": "string",
          "format": "date"
        },
        "source": {
          "description": "The name of the file in which this event is stored.",
          "type": [
            "string",
            "null"
          ]
        },
        "state": {
          "type": [
            "string",
            "null"
          ]
        },
        "styles": {
          "description": "The dance styles included in the event.",
          "default": [],
          "type": "array",
          "items": {
            "$ref": "#/definitions/DanceStyle"
          }
        },
        "workshop": {
          "description": "The event includes one or more workshops or lessons.",
          "default": false,
          "type": "boolean"
        }
      },
      "additionalProperties": false
    }
  }
}