← ShippoCONTENT HISTORY

Update to Shippo

Snapshot Sep 30, 2026 · 22:48 UTC · version 2.0.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "tracking",
  "description": "Track packages across carriers, view tracking history, and set up tracking webhooks via the Shippo API",
  "included_files": [
    {
      "relative_path": "shippo/references/address-formats.md",
      "size_in_bytes": 4083
    },
    {
      "relative_path": "shippo/references/carrier-guide.md",
      "size_in_bytes": 5690
    },
    {
      "relative_path": "shippo/references/csv-format.md",
      "size_in_bytes": 5976
    },
    {
      "relative_path": "shippo/references/customs-guide.md",
      "size_in_bytes": 9321
    },
    {
      "relative_path": "shippo/references/error-reference.md",
      "size_in_bytes": 11389
    },
    {
      "relative_path": "shippo/references/international-shipping.md",
      "size_in_bytes": 6910
    },
    {
      "relative_path": "shippo/references/label-formats.md",
      "size_in_bytes": 2825
    },
    {
      "relative_path": "shippo/references/rate-shopping-guide.md",
      "size_in_bytes": 4320
    },
    {
      "relative_path": "shippo/references/response-envelope.md",
      "size_in_bytes": 1184
    },
    {
      "relative_path": "shippo/references/tool-reference.md",
      "size_in_bytes": 15981
    }
  ],
  "skill_md_contents": "---\nname: tracking\ndescription: Track packages across carriers, view tracking history, and set up tracking webhooks via the Shippo API\nmetadata:\n  version: \"1.5.2\"\n---\n\n# Package Tracking\n\n## Track by Number\n\n1. Determine carrier and tracking number. Carrier must be a lowercase Shippo token (e.g., `usps`, `ups`, `fedex`, `dhl_express`). See `shippo/references/carrier-guide.md` for tracking number format hints per carrier. If uncertain, ask the user.\n2. Call `GetTrack` with `carrier` and `tracking_number`.\n3. Key response fields: `tracking_status` (status, status_details, status_date, location), `tracking_history`, `eta`.\n4. Each tracking event includes a `substatus` object with `code`, `text`, and `action_required` (boolean). Include substatus details when presenting tracking history -- these provide more specific information about what happened at each step.\n5. Present: current status, location, ETA, substatus details, and chronological event history (most recent first).\n\n---\n\n## Status Values\n\nSee `shippo/references/carrier-guide.md` for carrier-specific status nuances. Standard values:\n\n| Status | Meaning |\n|---|---|\n| PRE_TRANSIT | Label created, carrier has not received the package |\n| TRANSIT | Package is in transit |\n| DELIVERED | Delivered |\n| RETURNED | Being returned or returned to sender |\n| FAILURE | Delivery failed |\n| UNKNOWN | No tracking information from carrier |\n\nThe `eta` field is provided by most major carriers (USPS, UPS, FedEx, DHL Express) but availability is carrier-dependent, it may be `null` for regional carriers or for shipments before the carrier has finalized routing. Treat absence as informational, not as an error condition.\n\n---\n\n## Find Trackable Packages\n\nCall `ListTransactions`. Filter for `object_status: SUCCESS`. Each successful transaction has `tracking_number` and carrier info. Then call `GetTrack` for selected items.\n\n---\n\n## Register a Tracking Webhook\n\n1. Get the user's HTTPS webhook URL.\n2. Call `createWebhook` with `url` and `event: track_updated`.\n3. Optionally call `CreateTrack` with carrier and tracking number to register a specific shipment for push updates.\n\n---\n\n## Quick Reference\n\n**Track a package:**\n`GetTrack` with carrier + tracking number\n\n**Find past shipment tracking:**\n`ListTransactions` -> filter SUCCESS -> `GetTrack`\n"
}

SHA-256: e69cc81f70cd550bab7d40f1946307fe083ac6bf93928d9790997462b513393e