ScheduleInformation

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-exchange/json-schema/microsoft-exchange-schedule-information-schema.json",
  "title": "ScheduleInformation",
  "description": "Free/busy information for a user",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-exchange-scheduling-api-openapi.yml#/components/schemas/ScheduleInformation",
  "type": "object",
  "properties": {
    "scheduleId": {
      "type": "string",
      "description": "SMTP address of the user or resource"
    },
    "availabilityView": {
      "type": "string",
      "description": "Merged view of availability using single characters (0=free, 1=tentative, 2=busy, 3=oof, 4=workingElsewhere)"
    },
    "scheduleItems": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ScheduleItem"
      }
    },
    "workingHours": {
      "$ref": "#/$defs/WorkingHours"
    },
    "error": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string"
        },
        "responseCode": {
          "type": "string"
        }
      }
    }
  },
  "$defs": {
    "DateTimeTimeZone": {
      "type": "object",
      "description": "Describes a date, time, and time zone",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "A date and time in ISO 8601 format"
        },
        "timeZone": {
          "type": "string",
          "description": "A time zone name (e.g. Pacific Standard Time)"
        }
      }
    },
    "ScheduleItem": {
      "type": "object",
      "description": "An item that describes availability",
      "properties": {
        "start": {
          "$ref": "#/$defs/DateTimeTimeZone"
        },
        "end": {
          "$ref": "#/$defs/DateTimeTimeZone"
        },
        "isPrivate": {
          "type": "boolean"
        },
        "status": {
          "type": "string",
          "enum": [
            "free",
            "tentative",
            "busy",
            "oof",
            "workingElsewhere",
            "unknown"
          ]
        },
        "subject": {
          "type": "string"
        },
        "location": {
          "type": "string"
        }
      }
    },
    "WorkingHours": {
      "type": "object",
      "description": "Working hours for the user",
      "properties": {
        "daysOfWeek": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "sunday",
              "monday",
              "tuesday",
              "wednesday",
              "thursday",
              "friday",
              "saturday"
            ]
          }
        },
        "startTime": {
          "type": "string",
          "description": "The time of the day the work day starts"
        },
        "endTime": {
          "type": "string",
          "description": "The time of the day the work day ends"
        },
        "timeZone": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}