Summary Tracking Information

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/usps/json-schema/usps-tracking-summary-schema.json",
  "title": "Summary Tracking Information",
  "description": "Summary tracking information for the requested tracking number.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/usps-tracking-openapi.yml#/components/schemas/TrackingSummary",
  "type": "object",
  "properties": {
    "trackingNumber": {
      "type": "string",
      "description": "trackingNumber requested by the client."
    },
    "expectedDeliveryDate": {
      "type": "string",
      "description": "The expected delivery date.",
      "format": "date"
    },
    "expectedDeliveryTime": {
      "type": "string",
      "description": "The expected delivery time."
    },
    "guaranteedDeliveryDate": {
      "type": "string",
      "description": "Guaranteed Delivery Date: Global Express Mail only, certain countries provide a guarantee delivery For Example: April 15, 2020 Or 3 Business Days.  Will only be provided when a package has not yet  been delivered.",
      "format": "date"
    },
    "eventSummaries": {
      "maxItems": 99,
      "minItems": 1,
      "type": "array",
      "description": "Summarized tracking event information for the requested tracking number in reverse chronological order",
      "items": {
        "type": "string",
        "description": "The detailed tracking information from a point in-transit."
      }
    },
    "accessControl": {
      "$ref": "#/$defs/AccessControl"
    }
  },
  "additionalProperties": false,
  "$defs": {
    "AccessControl": {
      "title": "Access Control",
      "type": "string",
      "description": "Details on if the Tracking request was free or charged based on MID access through an IP Agreement.\n\n- `FREE` - The Tracking request was free.\n- `IP_AGREEMENT` - The tracking request was charged based on MID access through an IP Agreement.\n",
      "enum": [
        "FREE",
        "IP_AGREEMENT"
      ]
    }
  }
}