Get recipient details for attended deliveries

Learn how to get the recipient details for packages delivered to specific individuals other than the intended recipient.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API Applications.
• The Amazon Fulfillment role assigned to your developer profile.
• The Amazon Fulfillment role selected in the App registration page for your application.

Retrieve recipient details for attended deliveries

Call the getFulfillmentOrder operation. In the response:

1. Locate the shipment in the fulfillmentShipments array.
2. Locate the package in the fulfillmentShipmentPackage array.
3. Check the deliveryInformation.dropOffLocation object. This object contains two properties: type (string) and attributes (object). The type indicates where the package was delivered, and the attributes property provides recipient details based on delivery type.

Drop point types and associated fields

• FALLBACK_NEIGHBOR_DELIVERY

  • neighborName: Name of the neighbor who received the package
  • neighborDoorNumber: Door or unit number of the neighbor

• RECEPTIONIST

  • recipientName: Name of the receptionist who received the package

Sample response

{ 
  "payload": { 
    "fulfillmentShipments": [ 
      { 
        "amazonShipmentId": "DZfP8NjRw", 
        "fulfillmentShipmentPackage": [ 
          { 
            "packageNumber": 1, 
            "carrierCode": "AMZL_US", 
            "trackingNumber": "TBA123456789", 
            "deliveryInformation": { 
              "dropOffLocation": { 
                "type": "NEIGHBOR", 
                "attributes": { 
                  "neighborName": "John Smith", 
                  "neighborDoorNumber": "Apt 205" 
                } 
              } 
            } 
          } 
        ] 
      } 
    ] 
  } 
}