{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "the tracker id that can be used for requesting info about a tracker"
    },
    "carrier_tracking_no": {
      "type": "string",
      "description": "tracking number (provided by the carrier) for this shipment"
    },
    "status": {
      "type": "string",
      "enum": ["awaits_pickup_by_receiver", "canceled", "delayed", "delivered", "destroyed", "exception", "not_delivered", "notification", "out_for_delivery", "picked_up", "registered", "transit", "unknown"],
      "description": "key describing the current status"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "timestamp the tracker was created"
    },
    "from": {
      "$ref": "#/definitions/address",
      "description": "the senders address"
    },
    "tracking_status_updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "timestamp the tracking status was last updated"
    },
    "last_polling_at": {
      "type": "string",
      "format": "date-time",
      "description": "timestamp the shipment status was last polled at the carrier"
    },
    "next_polling_at": {
      "type": "string",
      "format": "date-time",
      "description": "timestamp the shipment status will be polled the next time"
    },
    "shipment_id": {
      "type": "string",
      "description": "id of the corresponding shipment within shipcloud"
    },
    "carrier": {
      "type": "string",
      "enum": ["angel_de", "cargo_international", "dhl", "dhl_express", "dpag", "dpd", "gls", "go", "hermes", "iloxx", "parcel_one", "ups"],
      "description": "acronym of the carrier the shipment was sent with"
    },
    "to": {
      "$ref": "#/definitions/address",
      "description": "the receivers address"
    },
    "tracking_events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "timestamp of when this event occured"
          },
          "location": {
            "type": "string",
            "description": "location of the package at this moment"
          },
          "status": {
            "type": "string",
            "enum": ["awaits_pickup_by_receiver", "canceled", "delayed", "delivered", "destroyed", "exception", "not_delivered", "notification", "out_for_delivery", "picked_up", "transit", "unknown"],
            "description": "Key describing the status. The initial status is 'registered'"
          },
          "details": {
            "type": "string",
            "description": "message the carrier sends to describe the shipments status"
          }
        },
        "required": ["timestamp", "location", "status", "details"],
        "additionalProperties": false
      }
    },
    "metadata": {
      "type": "object",
      "description": "additional data associated with the shipment"
    }
  },
  "required": ["id", "carrier_tracking_no", "status", "created_at", "tracking_status_updated_at", "last_polling_at", "next_polling_at", "shipment_id", "carrier"],
  "additionalProperties": false,
  "definitions": {
    "address": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "identifier of a previously created address"
        },
        "company": { "type": "string" },
        "first_name": { "type": "string" },
        "last_name": { "type": "string" },
        "care_of": { "type": "string" },
        "street": { "type": "string" },
        "street_no": { "type": "string" },
        "city": { "type": "string" },
        "zip_code": { "type": "string" },
        "state": { "type": "string" },
        "country": { "type": "string", "description": "Country as uppercase ISO 3166-1 alpha-2 code" },
        "phone": {
          "type": "string",
          "description": "telephone number"
        }
      },
      "required": ["last_name", "street", "street_no", "city", "zip_code", "country"],
      "additionalProperties": false
    }
  }
}