PACKAGE_DELIVERED
Buy with Prime API is now available for early access
Sign up for early access to the Buy with Prime API using the 'Sign Up' button below. The API may change as Amazon receives feedback and iterates on it.
The PACKAGE_DELIVERED
event is published when one or more items were delivered to their destination. Typically, this event means that the shopper has received some or all items that they ordered.
This event was previously called
DELIVERY_COMPLETED
.
The following examples are ways that you might use this event:
- To enable customer service agents to see that an item was delivered, so that they can give the customer accurate information if the customer reaches out by phone or email.
- To enable developers to update their order management system and all of the downstream systems. Examples of downstream systems are analytics and reporting on business performance, accounting for remitting taxes, customer service agents helping customers who reach out, and so on.
Required permission
To subscribe to this event, your API credentials must have at least Read Order permission. You choose permissions when you generate your API credentials. For details, see Authenticate to the Buy with Prime API.
Schema
Schema for webhook destinations
{
"idempotencyKey":"example-idempotency-key",
"eventDescriptor": "PACKAGE_DELIVERED",
"resources": [
"businessProduct/business-product-id/order/order-id/delivery/delivery-id"
],
"eventId":"example-event-id",
"apiVersion": "2024-11-01",
"subscriptionId": "example-subscription-id",
"eventTime":"2025-01-20T12:34:56Z",
"data": {}
}
Schema for Amazon EventBridge destinations
{
"version": "0",
"id": "example-event-id",
"detail-type": "PACKAGE_DELIVERED",
"source": "aws.partner/buywithprime/partner-event-source-name",
"account": "example-aws-account-id",
"time": "2025-01-20T12:34:56Z",
"region": "us-east-1",
"resources": [
"businessProduct/business-product-id/order/order-id/delivery/delivery-id"
],
"detail": {
"idempotencyKey":"example-idempotency-key",
"eventDescriptor": "PACKAGE_DELIVERED",
"resources": [
"businessProduct/business-product-id/order/order-id/delivery/delivery-id"
],
"eventId":"example-event-id",
"apiVersion": "2024-11-01",
"subscriptionId": "example-subscription-id",
"eventTime":"2025-01-20T12:34:56Z",
"data": {}
}
}
Fields
Key | Data type | Description |
---|---|---|
version | String | Amazon EventBridge event version. |
id | String | Amazon EventBridge-generated UUID for an event. |
detail-type | String | Type schema for the detail of the event, which in this case is PACKAGE_DELIVERED . |
source | String | Name of the partner event source in Amazon EventBridge. For details, see Subscribe to Events. |
account | String | AWS account ID that hosts the partner event source. |
time | String | ISO 8601 timestamp that indicates when the event was published. |
region | String | AWS region from which the event is published. |
resources | Array of strings | Array of identifiers for the resources that triggered the event, in key-value pair format. Each resource identifier is a string that starts with businessProduct/{businessProductId}/ , followed by resource types (keys) and resource IDs (values) separated by slashes. For details about how to interpret resources , see Subscribe to Events. |
detail | Object | JSON object that contains details about the event. For details, see detail fields. |
Detail fields
Key | Data type | Description |
---|---|---|
idempotencyKey | String | Unique identifier to detect duplicate events. |
eventDescriptor | String | Event type that determines the default query. |
resources | Array of strings | Array of identifiers for the resources that triggered the event, in key-value pair format. Each resource identifier is a string that starts with businessProduct/{businessProductId}/ , followed by resource types (keys) and resource IDs (values) separated by slashes. This field is the same value as resources at the top level. |
eventId | String | Unique identifier for this event. This field is the same value as id at the top level. |
apiVersion | String | Buy with Prime API version associated with this event. |
subscriptionId | String | Unique identifier for an event subscription. |
eventTime | String | ISO 8601 timestamp that indicates when the event was published. This field is the same value as time at the top level. |
data | Object | JSON object that can contain API response data. |
Handling the event
When you receive this event, you typically query the order to fetch the delivery information for all line items in the order. Take the following steps:
- Parse the
resources
array of the event to get the order ID and delivery ID. - Using the order ID that you found in the
resources
array in the previous step, make an API call to theorder
query. For examples of how to perform this query, see Query a Buy with Prime Order. - In the response, navigate to the
lineItems.packageInformation.details
array and find the element with the delivery ID that you found in theresources
array of the event in step 1. There, you will find the details of delivery and a set of products delivered together to the customer. Several lines items can have the same delivery ID.
Note: Depending on the moment that you call the Buy with Prime API with respect to delivery progress, the value of thestate
attribute in the delivery details is eitherIN_TRANSIT
,CANCELLED
, orDELIVERED
. For more information, seePACKAGE_DELIVERY_IN_TRANSIT
andPACKAGE_DELIVERY_CANCELLED
.
Related topics
Updated about 1 month ago