Overview

Amazon has rolled out a new AmazonPrograms array in the response of the Orders API v0 getOrderItems call. Effective immediately, every line‑item payload can include this array, which enumerates any Amazon‑run programs attached to the item, such as Subscribe & Save. Sellers who pull order data for fulfillment, inventory planning, or reporting must adapt their integrations to capture and act on this additional field.

Key Points

• New attribute added — The JSON returned by getOrderItems now contains an amazonPrograms key that holds an array of program identifiers for each order line item.
• Program identifiers — Items enrolled in Subscribe & Save appear with the string “SubscribeAndSave”; future Amazon initiatives will be added using the same format.
• Global rollout — The change is applied across all Amazon marketplaces, so sellers in the U.S., Canada, Europe, Japan, and other regions receive identical data structures.
• Optional field — The amazonPrograms array is only present when an item participates in a program; otherwise the key is omitted, preserving backward compatibility with existing parsers.
• Immediate availability — The attribute is live today and does not require a deprecation period for the previous response format.

How the Updated getOrderItems Response Works

1. API request — Your application sends a GET request to /orders/v0/orders/{orderId}/orderItems with the standard authentication headers.

   • Example: A call for order 112-1234567-8910112 returns a JSON object that lists each line item’s details, now including the new program data.

2. Response payload — For every line item, the JSON may contain an amazonPrograms key. When the item is part of a program, the key holds an array of strings; if not, the key is absent or empty.