Pre-launch Announcement: Introducing Proof of Delivery Information in Tracking API

We are excited to announce upcoming enhancements to the Amazon Shipping API Tracking capabilities. In response to user feedback and to improve the shipping experience, we will be introducing Proof of Delivery (POD) information in the getTracking API.

Key Updates

Photo on delivery images: Available as a URL via the API
Receiver Information: Name of the person receiving and/or signing for the package (if available)
Delivery location geo-coordinates: Latitude and longitude of the delivery location

These new features will be accessible through the existing Tracking API, enhancing the information available to shippers and integrators without requiring significant changes to their current integration.

Schema Details

The updated GetTrackingResult schema will include a new "proofOfDelivery" structure within the "summary" object:

{
  "proofOfDelivery": {
    "type": "object",
    "description": "Contains the proof of delivery information for a package, if available and permitted.",
    "properties": {
      "deliveryLocationCoordinates": {
        "type": "object",
        "description": "This attribute exists only when available. The geographical coordinate of the package delivery location.",
        "properties": {
          "latitude": {
            "type": "number",
            "format": "float"
          },
          "longitude": {
            "type": "number",
            "format": "float"
          }
        }
      },
      "deliveryImageURL": {
        "type": "string",
        "description": "This attribute exists only when available. A temporary URL that provides access to the image taken at the time of delivery. This URL is dynamically generated with each request, and remains valid for 72 hours before expiring. If the delivery image is needed again, another getTracking request can be made."
      },
      "signatureImageURL": { // Placeholder, would soon be populated around Q4, 2025
        "type": "string",
        "description": "This attribute exists only when available. A temporary URL that provides access to the signature given at the time of delivery. This URL is dynamically generated with each request, and remains valid for 72 hours before expiring. If the signature image is needed again, another getTracking request can be made."
      },
      "receivedBy": {
        "type": "string",
        "description": "This attribute exists only when available. The recorded person or entity who received the package."
      }
    }
  }
}

{  
  "payload": {  
    "trackingId": "UK0123456789",  
    "alternateLegTrackingId": "UK0000XXX11X",  
    "eventHistory": [  
      {  
        "eventCode": "ReadyForReceive",  
        "eventTime": "2023-12-11T04:11:31Z",  
        "shipmentType": "FORWARD",  
        "location": {}  
      },  
      {  
        "eventCode": "Delivered",  
        "eventTime": "2023-12-14T15:30:00Z",  
        "shipmentType": "FORWARD",  
        "location": {  
          "city": "London",  
          "countryCode": "GB",  
          "postalCode": "SXXA 1XX",  
          "stateOrRegion": "England"  
        }  
      }  
    ],  
    "promisedDeliveryDate": "2023-12-14T20:00:00Z",  
    "summary": {  
      "status": "Delivered",  
      "trackingDetailCodes": {  
        "forward": ["Delivered"],  
        "returns": []  
      },  
      "proofOfDelivery": {  
        "deliveryLocationCoordinates": {
                "latitude": 51.5074,
                "longitude": -0.1278
            },
            "deliveryImageURL": "https://amzn-s3-dXXXXX.amazonaws.com/key?XXXXXXe96d844123456",
            "receivedBy": "John Doe"
        }
      }  
    }  
  }

Important Notes

This update will be available only to authenticated users of the Tracking API
POD information will be provided only when the calling entity’s shipper ID is authorized for the requested tracking ID
The photo URL will expire after 3 days, However, a fresh URL can be generated by making another call.
The "signatureImageURL" is placeholder for now, will be populated in Q4 2025.

We are currently in the final stages of development and testing. We anticipate launching these new features in April 2025.

FAQs

Are these fields available in the API Reference Docs?
Yes, the updated tracking API response schema will be available under the API Reference Page on or before May 3rd, 2025.
Can I keep using my GetTracking API after the rollout of new fields?
Yes, you can continue using your API without mapping the new fields, ensuring backward compatibility.
Do I need to map the new fields immediately?
No, you can continue using the existing API without mapping the new fields and plan to incorporate them at your convenience.
Is there a way to opt out of receiving additional information?
Currently, there isn't an option to opt out of receiving additional information for the GetTracking API.
Will these changes impact Push Notifications?
No, these changes will not impact push notifications which will continue to deliver the same information as before without any added proof of delivery information as in the tracking API response.
How long is the Image URL valid for?
The image URL and other proof of delivery information can be fetched for the same duration as the tracking information. The URL received in each response will be a unique pre-signed URL that expires after 3 days. If you need to reference the image more than 3 days after the initial request, a fresh call must be made within the valid tracking window to fetch a renewed URL.
What action is required from my end?
To leverage these new fields, ensure that your mapping is updated to accommodate the additional fields. Make the necessary adjustments in your systems or applications to capture and process the enhanced tracking data.

For any questions or concerns, please contact your Amazon Shipping integration team or reach out to our support team.