SearchOrdersResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-seller-central/main/json-schema/amazon-seller-central-search-orders-response-schema.json",
  "title": "SearchOrdersResponse",
  "description": "A list of orders.",
  "x-generated": "2026-09-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-seller-central-searchorders-api-openapi.yml#/components/schemas/SearchOrdersResponse",
  "type": "object",
  "required": [
    "orders"
  ],
  "properties": {
    "orders": {
      "description": "An array containing all orders that match the search criteria.",
      "type": "array",
      "items": {
        "$ref": "#/$defs/Order"
      }
    },
    "pagination": {
      "$ref": "#/$defs/Pagination",
      "description": "Pagination occurs when a request has results that exceed the response limit. This means the results are divided into individual pages. To retrieve a different page, you must pass the token value as the `paginationToken` query parameter in the subsequent request. All other parameters must be provided with the same values that were provided with the request that generated this token, with the exception of `maxResultsPerPage` and `includedData`, which can be modified between calls. The token will expire after 24 hours. When there are no other pages to fetch, the `pagination` field will be absent from the response."
    },
    "lastUpdatedBefore": {
      "type": "string",
      "format": "date-time",
      "description": "Only orders updated before the specified time are returned. The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format."
    },
    "createdBefore": {
      "type": "string",
      "format": "date-time",
      "description": "Only orders placed before the specified time are returned. The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format."
    }
  },
  "$defs": {
    "AddressExtendedFields": {
      "description": "Additional address components that provide more detailed location information, helping with precise delivery routing. \n\n**Note**: Only available with Brazil shipping addresses.",
      "type": "object",
      "properties": {
        "streetName": {
          "type": "string",
          "description": "The name of the street."
        },
        "streetNumber": {
          "type": "string",
          "description": "The house, building, or property number associated with the location's street address."
        },
        "complement": {
          "type": "string",
          "description": "The floor number / unit number."
        },
        "neighborhood": {
          "type": "string",
          "description": "The neighborhood. This value is only used in some countries (such as Brazil)."
        }
      }
    },
    "Alias": {
      "description": "An alternative identifier that provides a different way to reference the same order.",
      "type": "object",
      "required": [
        "aliasId",
        "aliasType"
      ],
      "properties": {
        "aliasId": {
          "description": "The alternative identifier value that can be used to reference this order.",
          "type": "string"
        },
        "aliasType": {
          "description": "The kind of alternative identifier this represents.\n\n**Possible values**: `SELLER_ORDER_ID`",
          "type": "string"
        }
      }
    },
    "Asin": {
      "description": "The Amazon Standard Identification Number (ASIN), which uniquely identifies a product (catalog item).",
      "type": "string"
    },
    "AssociatedOrder": {
      "description": "Another order that has a direct business relationship with the current order, such as replacements or exchanges.",
      "type": "object",
      "properties": {
        "orderId": {
          "description": "The unique identifier of the related order that is associated with the current order.",
          "type": "string"
        },
        "associationType": {
          "description": "The relationship between the current order and the associated order.\n\n**Possible values**: `REPLACEMENT_ORIGINAL_ID`, `EXCHANGE_ORIGINAL_ID`",
          "type": "string"
        }
      }
    },
    "AssociatedOrderItem": {
      "description": "An associated order item that a customer has purchased with the product. For example, a tire installation service purchased with tires.",
      "type": "object",
      "properties": {
        "orderId": {
          "description": "The order identifier of the associated order item.",
          "type": "string"
        },
        "orderItemId": {
          "description": "The order item identifier of the associated order item.",
          "type": "string"
        },
        "associationType": {
          "description": "The type of association between the order items.\n\n**Possible values**:\n- `VALUE_ADD_SERVICE` (The associated item is a service order)",
          "type": "string"
        }
      }
    },
    "BusinessHour": {
      "type": "object",
      "description": "Business days and hours when the destination is open for deliveries.",
      "properties": {
        "dayOfWeek": {
          "type": "string",
          "description": "Specific day of the week for which operating hours are being defined.",
          "enum": [
            "SUN",
            "MON",
            "TUE",
            "WED",
            "THU",
            "FRI",
            "SAT"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "SUN",
              "description": "Sunday"
            },
            {
              "value": "MON",
              "description": "Monday"
            },
            {
              "value": "TUE",
              "description": "Tuesday"
            },
            {
              "value": "WED",
              "description": "Wednesday"
            },
            {
              "value": "THU",
              "description": "Thursday"
            },
            {
              "value": "FRI",
              "description": "Friday"
            },
            {
              "value": "SAT",
              "description": "Saturday"
            }
          ]
        },
        "timeWindows": {
          "type": "array",
          "description": "Collection of time windows during which the location is available for deliveries on the specified day.",
          "items": {
            "$ref": "#/$defs/TimeWindow"
          }
        }
      }
    },
    "Buyer": {
      "description": "Information about the customer who purchased the order.",
      "type": "object",
      "properties": {
        "buyerName": {
          "description": "The full name of the customer who placed the order.",
          "type": "string"
        },
        "buyerEmail": {
          "description": "The anonymized email address of the buyer. **Note:** Only available for merchant-fulfilled (FBM) orders.",
          "type": "string"
        },
        "buyerCompanyName": {
          "description": "The name of the company or organization for a business order.",
          "type": "string"
        },
        "buyerPurchaseOrderNumber": {
          "description": "The purchase order (PO) number entered by the buyer at checkout. Only returned for orders where the buyer entered a PO number at checkout.",
          "type": "string"
        }
      }
    },
    "ConstraintType": {
      "type": "string",
      "description": "Classification of the enforcement level required for shipping and delivery constraints.",
      "enum": [
        "MANDATORY"
      ],
      "x-docgen-enum-table-extension": [
        {
          "value": "MANDATORY",
          "description": "Constraint that must be strictly enforced for delivery."
        }
      ]
    },
    "CustomerAddress": {
      "description": "The physical address of the customer.",
      "type": "object",
      "properties": {
        "name": {
          "description": "The full name of the person who will receive the delivery at this address.",
          "type": "string"
        },
        "companyName": {
          "type": "string",
          "description": "The name of the business or organization at this address."
        },
        "addressLine1": {
          "description": "The primary street address.",
          "type": "string"
        },
        "addressLine2": {
          "description": "Additional address information.",
          "type": "string"
        },
        "addressLine3": {
          "description": "Additional address information.",
          "type": "string"
        },
        "city": {
          "description": "The city of the address.",
          "type": "string"
        },
        "districtOrCounty": {
          "description": "The district or county of the address.",
          "type": "string"
        },
        "stateOrRegion": {
          "description": "The state, province, or region of the address.",
          "type": "string"
        },
        "municipality": {
          "type": "string",
          "description": "The municipality of the address."
        },
        "postalCode": {
          "description": "The postal code, ZIP code, or equivalent mailing code of the address.",
          "type": "string"
        },
        "countryCode": {
          "description": "The two-letter country code identifying the country of the address, in ISO 3166-1 format.",
          "type": "string"
        },
        "phone": {
          "description": "The contact phone number for delivery coordination and customer communication.\n\n**Note**: The buyer phone number will be suppressed in some cases, including but not limited to:\n\n- All FBA (Fulfillment by Amazon) orders.\n- Shipped FBM (Fulfilled by the merchant) orders when current date is past the latest delivery date.",
          "type": "string"
        },
        "extendedFields": {
          "description": "Additional address components specific to certain countries that provide more detailed location information.\n\n**Note**: Only available with Brazil shipping addresses.",
          "$ref": "#/$defs/AddressExtendedFields"
        },
        "addressType": {
          "description": "The type of location.\n\n**Possible values**: `RESIDENTIAL`, `COMMERCIAL`, `PICKUP_POINT`",
          "type": "string"
        }
      }
    },
    "DateTimeRange": {
      "description": "A time period with start and end boundaries.",
      "type": "object",
      "properties": {
        "earliestDateTime": {
          "description": "The beginning of the time period, in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.",
          "type": "string",
          "format": "date-time"
        },
        "latestDateTime": {
          "description": "The end of the time period, in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.",
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "Decimal": {
      "description": "A decimal number with no loss of precision. Follows RFC 7159 for number representation.",
      "type": "string"
    },
    "DeliveryPreference": {
      "description": "Contains all delivery instructions that the customer provides for the shipping address.",
      "type": "object",
      "properties": {
        "dropOffLocation": {
          "type": "string",
          "description": "The drop-off location selected by the customer."
        },
        "addressInstruction": {
          "type": "string",
          "description": "Building instructions, nearby landmark, or navigation instructions."
        },
        "deliveryTime": {
          "$ref": "#/$defs/PreferredDeliveryTime",
          "description": "Business hours and days when the delivery is preferred."
        },
        "deliveryCapabilities": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/PreferredDeliveryCapability"
          },
          "description": "A list of miscellaneous delivery capabilities associated with the shipping address."
        }
      }
    },
    "ExceptionDate": {
      "type": "object",
      "description": "Special dates when normal business hours are modified or suspended, requiring different delivery scheduling.",
      "properties": {
        "exceptionDate": {
          "description": "Specific calendar date when normal operating hours do not apply. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format at day granularity.",
          "type": "string",
          "format": "date"
        },
        "exceptionDateType": {
          "description": "Operational status of the business on the specified exception date.",
          "type": "string",
          "enum": [
            "CLOSED",
            "OPEN"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "CLOSED",
              "description": "Business operations are suspended on this date."
            },
            {
              "value": "OPEN",
              "description": "Business operations are active on this date."
            }
          ]
        },
        "timeWindows": {
          "type": "array",
          "description": "Alternative operating hours that apply specifically to this exception date.",
          "items": {
            "$ref": "#/$defs/TimeWindow"
          }
        }
      }
    },
    "FulfillmentOrder": {
      "description": "Information about a fulfillment order associated with a customer order. A fulfillment order represents a unit of fulfillment created by Amazon for the order. **Note:** Only available for EasyShip orders at present.",
      "type": "object",
      "required": [
        "fulfillmentOrderId"
      ],
      "properties": {
        "fulfillmentOrderId": {
          "description": "The Fulfillment Order ID assigned by Amazon after fulfillment planning. This identifier is identical to the Shipment ID required by External Fulfillment APIs.",
          "type": "string"
        }
      }
    },
    "FulfillmentStatus": {
      "description": "The current fulfillment status of an order, indicating where the order is in the fulfillment process from placement to handover to carrier.",
      "type": "string",
      "enum": [
        "PENDING_AVAILABILITY",
        "PENDING",
        "UNSHIPPED",
        "PARTIALLY_SHIPPED",
        "SHIPPED",
        "CANCELLED",
        "UNFULFILLABLE"
      ],
      "x-docgen-enum-table-extension": [
        {
          "value": "PENDING_AVAILABILITY",
          "description": "This status is available for pre-orders only. The order has been placed, payment has not been authorized, and the release date of the item is in the future. The order is not ready for shipment."
        },
        {
          "value": "PENDING",
          "description": "The order has been placed but is not ready for shipment. For standard orders, the initial order status is `PENDING`. For pre-orders, the initial order status is `PENDING_AVAILABILITY`, and the order passes into the `PENDING` status when payment authorization begins."
        },
        {
          "value": "UNSHIPPED",
          "description": "The order is ready for shipment, but no items in the order have been shipped."
        },
        {
          "value": "PARTIALLY_SHIPPED",
          "description": "At least one, but not all, items in the order have been shipped."
        },
        {
          "value": "SHIPPED",
          "description": "All items have been shipped to the customer."
        },
        {
          "value": "CANCELLED",
          "description": "The order has been canceled and will not be fulfilled."
        },
        {
          "value": "UNFULFILLABLE",
          "description": "The order cannot be fulfilled. This state only applies to Amazon-fulfilled orders that were not placed on Amazon's retail website."
        }
      ]
    },
    "GiftOption": {
      "description": "Gift wrapping and personalization options selected by the customer for an order item.",
      "type": "object",
      "properties": {
        "giftMessage": {
          "description": "Personal message from the buyer to be included with the gift-wrapped item.",
          "type": "string"
        },
        "giftWrapLevel": {
          "description": "Type or quality level of gift wrapping service selected by the customer.",
          "type": "string"
        }
      }
    },
    "HourMinute": {
      "type": "object",
      "description": "The time when the business opens or closes.",
      "properties": {
        "hour": {
          "type": "integer",
          "description": "The hour when the business opens or closes, in 24-hour format (0-23)."
        },
        "minute": {
          "type": "integer",
          "description": "The minute when the business opens or closes."
        }
      }
    },
    "ItemCancellation": {
      "description": "The cancellation information of the order item.",
      "type": "object",
      "properties": {
        "cancellationRequest": {
          "description": "Details of the cancellation request submitted for this order item.",
          "$ref": "#/$defs/ItemCancellationRequest"
        },
        "cancellationExecution": {
          "description": "Details of how the cancellation was executed for this order item.",
          "$ref": "#/$defs/ItemCancellationExecution"
        }
      }
    },
    "ItemCancellationExecution": {
      "description": "Details of how the cancellation was executed for a specific order item, including who performed the cancellation and the reason.",
      "type": "object",
      "properties": {
        "cancelledBy": {
          "description": "Entity that executed the cancellation for this item. \n\n**Possible values**: `BUYER`, `MERCHANT`, `AMAZON`",
          "type": "string"
        },
        "cancelReason": {
          "description": "Explanation provided for why the cancellation was executed.",
          "type": "string"
        }
      }
    },
    "ItemCancellationRequest": {
      "description": "Detailed information about a cancellation request submitted for a specific order item.",
      "type": "object",
      "properties": {
        "requester": {
          "description": "Entity that initiated the cancellation request for this item. \n\n**Possible values**: `BUYER`",
          "type": "string"
        },
        "cancelReason": {
          "description": "Explanation provided for why the cancellation was requested.",
          "type": "string"
        }
      }
    },
    "ItemCondition": {
      "description": "Detailed information about the physical condition and quality state of the item being sold.",
      "type": "object",
      "properties": {
        "conditionType": {
          "description": "The primary condition category that broadly describes the item's state.\n\n**Possible values**: `NEW`, `USED`, `COLLECTIBLE`, `REFURBISHED`, `PREORDER`, `CLUB`.",
          "type": "string"
        },
        "conditionSubtype": {
          "description": "A more specific condition classification that provides additional detail about the item's quality within the main condition type.\n\n**Possible values**: `NEW`, `MINT`, `VERY_GOOD`, `GOOD`, `ACCEPTABLE`, `POOR`, `CLUB`, `OEM`, `WARRANTY`, `REFURBISHED_WARRANTY`, `REFURBISHED`, `OPEN_BOX`, `ANY`, `OTHER`.",
          "type": "string"
        },
        "conditionNote": {
          "description": "Additional details provided by the seller to describe the specific condition of this particular item.",
          "type": "string"
        }
      }
    },
    "ItemCustomization": {
      "description": "Information about any personalization, customization, or special modifications applied to this order item.",
      "type": "object",
      "properties": {
        "customizedUrl": {
          "description": "The URL of the customized data for custom orders from the Amazon Custom program.",
          "type": "string"
        }
      }
    },
    "ItemExpense": {
      "description": "The expense information related to this specific item.",
      "type": "object",
      "properties": {
        "pointsCost": {
          "description": "The cost of points.",
          "$ref": "#/$defs/ItemPointsCost"
        }
      }
    },
    "ItemFulfillment": {
      "description": "Information about how the order item should be processed, packed, and shipped to the customer.",
      "type": "object",
      "properties": {
        "quantityFulfilled": {
          "description": "The number of units of this item that have been successfully processed and shipped.",
          "type": "integer"
        },
        "quantityUnfulfilled": {
          "description": "The number of units of this item that remain to be processed and shipped.",
          "type": "integer"
        },
        "picking": {
          "description": "Information related to the warehouse picking process for this item.",
          "$ref": "#/$defs/ItemPicking"
        },
        "packing": {
          "description": "Information related to the packaging process for this item.",
          "$ref": "#/$defs/ItemPacking"
        },
        "shipping": {
          "description": "Information related to the shipping and delivery process for this item.",
          "$ref": "#/$defs/ItemShipping"
        }
      }
    },
    "ItemInternationalShipping": {
      "description": "Additional requirements needed for cross-border shipping of an order item.",
      "type": "object",
      "properties": {
        "iossNumber": {
          "description": "Import One-Stop Shop registration number required for EU VAT compliance when shipping from outside the European Union. Sellers shipping to the EU from outside the EU must provide this IOSS number to their carrier when Amazon has collected the VAT on the sale.",
          "type": "string"
        }
      }
    },
    "ItemPacking": {
      "description": "Information related to the packaging process for an order item.",
      "type": "object",
      "properties": {
        "giftOption": {
          "description": "Gift wrapping and messaging specified for this item.",
          "$ref": "#/$defs/GiftOption"
        },
        "serialNumberRequirement": {
          "description": "Whether serial numbers must be provided for this line item.",
          "$ref": "#/$defs/SerialNumberRequirement"
        }
      }
    },
    "ItemPicking": {
      "description": "Information related to the warehouse picking process for an order item.",
      "type": "object",
      "properties": {
        "substitutionPreference": {
          "description": "Substitution preference for an order item when it becomes unavailable during fulfillment.",
          "$ref": "#/$defs/ItemSubstitutionPreference"
        }
      }
    },
    "ItemPointsCost": {
      "description": "Information about Amazon Points granted with the purchase of an item, including both quantity and monetary equivalent value.",
      "type": "object",
      "properties": {
        "pointsGranted": {
          "description": "Details of the Amazon Points granted, including count and monetary value.",
          "$ref": "#/$defs/PointsGranted"
        }
      }
    },
    "ItemPrice": {
      "description": "Pricing information for the order item.",
      "type": "object",
      "properties": {
        "unitPrice": {
          "description": "The price charged for a single unit of this product, before any quantity-based calculations.",
          "$ref": "#/$defs/Money"
        },
        "priceDesignation": {
          "description": "Indicates that the selling price is a special price that is only available for Amazon Business orders. For more information about the Amazon Business Seller Program, refer to the [Amazon Business website](https://www.amazon.com/b2b/info/amazon-business).\n\n**Possible value**: `BUSINESS_PRICE`",
          "type": "string"
        }
      }
    },
    "ItemProceeds": {
      "description": "The money that the seller receives from the sale of this specific item.",
      "type": "object",
      "properties": {
        "proceedsTotal": {
          "description": "The total monetary amount for this order item.",
          "$ref": "#/$defs/Money"
        },
        "breakdowns": {
          "description": "The breakdown of proceeds.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/ItemProceedsBreakdown"
          }
        }
      }
    },
    "ItemProceedsBreakdown": {
      "description": "Detailed proceeds breakdown for a specific order item.",
      "type": "object",
      "required": [
        "type",
        "subtotal"
      ],
      "properties": {
        "type": {
          "description": "Category classification of the proceeds breakdown. \n\n**Possible values**: `ITEM`, `SHIPPING`, `GIFT_WRAP`, `COD_FEE`, `OTHER`, `TAX`, `DISCOUNT`",
          "type": "string"
        },
        "subtotal": {
          "description": "Monetary amount for the proceeds breakdown.",
          "$ref": "#/$defs/Money"
        },
        "detailedBreakdowns": {
          "description": "Further granular breakdown of the subtotal.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/ItemProceedsDetailedBreakdown"
          }
        }
      }
    },
    "ItemProceedsDetailedBreakdown": {
      "description": "Further granular breakdown of the subtotal of the proceeds breakdown, only available for TAX and DISCOUNT proceeds types.",
      "type": "object",
      "properties": {
        "subtype": {
          "description": "Specific classification of the further granular breakdown. \n\n**Possible values**: `ITEM`, `SHIPPING`, `GIFT_WRAP`, `COD_FEE`, `OTHER`, `DISCOUNT`",
          "type": "string"
        },
        "value": {
          "description": "Monetary amount for the further granular breakdown.",
          "$ref": "#/$defs/Money"
        }
      }
    },
    "ItemProduct": {
      "description": "Product information for an order item.",
      "type": "object",
      "properties": {
        "asin": {
          "description": "The Amazon Standard Identification Number (ASIN) of the item.",
          "$ref": "#/$defs/Asin"
        },
        "title": {
          "description": "The product name or title as displayed to customers in the marketplace.",
          "type": "string"
        },
        "sellerSku": {
          "description": "The item's seller stock keeping unit (SKU).",
          "$ref": "#/$defs/SKU"
        },
        "condition": {
          "description": "Information about the physical condition and quality of the item being sold.",
          "$ref": "#/$defs/ItemCondition"
        },
        "price": {
          "description": "Pricing information for this product.",
          "$ref": "#/$defs/ItemPrice"
        },
        "serialNumbers": {
          "description": "Unique serial numbers for products that require individual tracking, typically provided for FBA orders.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "customization": {
          "description": "Information about any personalization or customization applied to this product.",
          "$ref": "#/$defs/ItemCustomization"
        }
      }
    },
    "ItemPromotion": {
      "description": "Details about any discounts, coupons, or promotional offers applied to this item.",
      "type": "object",
      "properties": {
        "breakdowns": {
          "description": "A list of promotions applied to the order item.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/ItemPromotionBreakdown"
          }
        }
      }
    },
    "ItemPromotionBreakdown": {
      "description": "Detailed information about a specific promotional offer applied to an order item.",
      "type": "object",
      "properties": {
        "promotionId": {
          "description": "Unique identifier for the promotion applied to this item.",
          "type": "string"
        }
      }
    },
    "ItemShipping": {
      "description": "Information related to the shipping and delivery process for an order item.",
      "type": "object",
      "properties": {
        "scheduledDeliveryWindow": {
          "description": "When this item is expected to be delivered to the customer.",
          "$ref": "#/$defs/DateTimeRange"
        },
        "shippingConstraints": {
          "description": "Special shipping requirements and restrictions that apply to this item.",
          "$ref": "#/$defs/ItemShippingConstraints"
        },
        "internationalShipping": {
          "description": "Additional information needed for cross-border delivery of this item.",
          "$ref": "#/$defs/ItemInternationalShipping"
        }
      }
    },
    "ItemShippingConstraints": {
      "description": "Special shipping requirements and restrictions that must be observed when shipping an order item.",
      "type": "object",
      "properties": {
        "palletDelivery": {
          "description": "The line item must be delivered by pallet.",
          "$ref": "#/$defs/ConstraintType"
        },
        "cashOnDelivery": {
          "description": "Payment must be collected from the customer at the time of delivery.",
          "$ref": "#/$defs/ConstraintType"
        },
        "signatureConfirmation": {
          "description": "The recipient of the line item must sign to confirm its delivery.",
          "$ref": "#/$defs/ConstraintType"
        },
        "recipientIdentityVerification": {
          "description": "The person receiving the line item must be the same as the intended recipient of the order.",
          "$ref": "#/$defs/ConstraintType"
        },
        "recipientAgeVerification": {
          "description": "The carrier must confirm that the recipient is of the legal age to receive the line item upon delivery.",
          "$ref": "#/$defs/ConstraintType"
        }
      }
    },
    "ItemSubstitutionOption": {
      "type": "object",
      "description": "Alternative product that can be substituted for an original order item when it becomes unavailable during fulfillment.",
      "properties": {
        "asin": {
          "type": "string",
          "description": "Amazon Standard Identification Number of the substitute product."
        },
        "quantityOrdered": {
          "type": "integer",
          "description": "Number of units of the substitute item to be selected if substitution occurs."
        },
        "sellerSku": {
          "type": "string",
          "description": "The item's seller stock keeping unit (SKU)."
        },
        "title": {
          "type": "string",
          "description": "Product name or title of the substitute item as displayed to customers."
        },
        "measurement": {
          "description": "Unit of measure and quantity specifications for the substitute product.",
          "$ref": "#/$defs/Measurement"
        }
      }
    },
    "ItemSubstitutionPreference": {
      "type": "object",
      "description": "Substitution preference for an order item when it becomes unavailable during fulfillment.",
      "required": [
        "substitutionType"
      ],
      "properties": {
        "substitutionType": {
          "type": "string",
          "description": "Source and nature of the substitution preferences for this item.",
          "enum": [
            "CUSTOMER_PREFERENCE",
            "AMAZON_RECOMMENDED",
            "DO_NOT_SUBSTITUTE"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "CUSTOMER_PREFERENCE",
              "description": "Substitution preferences defined by the customer"
            },
            {
              "value": "AMAZON_RECOMMENDED",
              "description": "Substitution options suggested by Amazon's system"
            },
            {
              "value": "DO_NOT_SUBSTITUTE",
              "description": "Prohibition against any item substitutions"
            }
          ]
        },
        "substitutionOptions": {
          "type": "array",
          "description": "List of alternative products that can be substituted for the original item if it becomes unavailable.",
          "items": {
            "$ref": "#/$defs/ItemSubstitutionOption"
          }
        }
      }
    },
    "ItemTax": {
      "description": "Tax information for an order item.",
      "type": "object",
      "properties": {
        "taxCalculationBreakdowns": {
          "description": "A list of tax calculation breakdowns for the order item.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/ItemTaxCalculationBreakdown

# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amazon-seller-central/refs/heads/main/json-schema/amazon-seller-central-search-orders-response-schema.json