When you subscribe to tracking events, Pitney Bowes sends a JSON payload to your configured webhook endpoint each time a carrier provides a status update for a shipment. This page describes the payload structure and shows sample payloads for supported carriers.
For details on subscribing to tracking events, see the Subscribe Tracking Details API.
UPS Sample Payload
{
"carrier": "UPS",
"carrierEventCode": "M",
"carrierEventDescription": "Shipper created a label, UPS has not received the package yet.",
"deliveryDate": "",
"deliveryTime": "",
"destinationAddress": {
"city": "Beverly Hills",
"country": "US",
"description": "",
"postalCode": "90210-4877",
"stateOrProvince": "CA"
},
"estimatedDeliveryDate": null,
"estimatedDeliveryTime": null,
"eventCode": "PSR",
"eventDate": "2025-08-08",
"eventDescription": "Tracking details uploaded",
"eventLocation": {
"city": "",
"country": "US",
"description": "",
"postalCode": "",
"stateOrProvince": ""
},
"eventTime": "13:22:16",
"packageStatus": "Manifest",
"serviceCode": "518",
"serviceName": "UPS Ground",
"trackingNumber": "1ZJ4656E0320200543"
}USPS Sample Payload
{
"carrier": "USPS",
"carrierEventCode": "GX",
"carrierEventDescription": "Shipping Label Created, USPS Awaiting Item",
"deliveryDate": "",
"deliveryTime": "",
"destinationAddress": {
"city": "Shelton",
"country": "US",
"description": "",
"postalCode": "06484-4301",
"stateOrProvince": "CT"
},
"estimatedDeliveryDate": null,
"estimatedDeliveryTime": null,
"eventCode": "PSR",
"eventDate": "2025-08-08",
"eventDescription": "Tracking details uploaded",
"eventLocation": {
"city": "BROOKLYN",
"country": "",
"description": "",
"postalCode": "11201",
"stateOrProvince": "NY"
},
"eventTime": "14:31:00",
"packageStatus": "Manifest",
"serviceCode": "001",
"serviceName": "USPS Ground Advantage",
"trackingNumber": "9400140105156006332686"
}