GetOrderItemsBuyerInfoResponse

{
  "$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-get-order-items-buyer-info-response-schema.json",
  "title": "GetOrderItemsBuyerInfoResponse",
  "description": "The response schema for the `getOrderItemsBuyerInfo` operation.",
  "x-generated": "2026-09-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-seller-central-ordersv0-api-openapi.yml#/components/schemas/GetOrderItemsBuyerInfoResponse",
  "type": "object",
  "properties": {
    "payload": {
      "description": "The payload for the `getOrderItemsBuyerInfo` operation.",
      "$ref": "#/$defs/OrderItemsBuyerInfoList"
    },
    "errors": {
      "description": "One or more unexpected errors occurred during the `getOrderItemsBuyerInfo` operation.",
      "$ref": "#/$defs/ErrorList"
    }
  },
  "$defs": {
    "BuyerCustomizedInfoDetail": {
      "type": "object",
      "properties": {
        "CustomizedURL": {
          "type": "string",
          "description": "The location of a ZIP file containing Amazon Custom data."
        }
      },
      "description": "Buyer information for custom orders from the Amazon Custom program."
    },
    "Error": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string",
          "description": "An error code that identifies the type of error that occurred."
        },
        "message": {
          "type": "string",
          "description": "A message that describes the error condition."
        },
        "details": {
          "type": "string",
          "description": "Additional details that can help the caller understand or fix the issue."
        }
      },
      "description": "Error response returned when the request is unsuccessful."
    },
    "ErrorList": {
      "type": "array",
      "description": "A list of error responses returned when a request is unsuccessful.",
      "items": {
        "$ref": "#/$defs/Error"
      }
    },
    "Money": {
      "type": "object",
      "properties": {
        "CurrencyCode": {
          "type": "string",
          "description": "The three-digit currency code. In ISO 4217 format."
        },
        "Amount": {
          "type": "string",
          "description": "The currency amount."
        }
      },
      "description": "The monetary value of the order."
    },
    "OrderItemBuyerInfo": {
      "type": "object",
      "required": [
        "OrderItemId"
      ],
      "properties": {
        "OrderItemId": {
          "type": "string",
          "description": "An Amazon-defined order item identifier."
        },
        "BuyerCustomizedInfo": {
          "description": "Buyer information for custom orders from the Amazon Custom program.\n\n**Note**: This attribute is only available for MFN (fulfilled by seller) orders.",
          "$ref": "#/$defs/BuyerCustomizedInfoDetail"
        },
        "GiftWrapPrice": {
          "description": "The gift wrap price of the item.",
          "$ref": "#/$defs/Money"
        },
        "GiftWrapTax": {
          "description": "The tax on the gift wrap price.",
          "$ref": "#/$defs/Money"
        },
        "GiftMessageText": {
          "type": "string",
          "description": "A gift message provided by the buyer.\n\n**Note**: This attribute is only available for MFN (fulfilled by seller) orders."
        },
        "GiftWrapLevel": {
          "type": "string",
          "description": "The gift wrap level specified by the buyer."
        }
      },
      "description": "A single order item's buyer information."
    },
    "OrderItemBuyerInfoList": {
      "type": "array",
      "description": "A single order item's buyer information list.",
      "items": {
        "$ref": "#/$defs/OrderItemBuyerInfo"
      }
    },
    "OrderItemsBuyerInfoList": {
      "type": "object",
      "required": [
        "AmazonOrderId",
        "OrderItems"
      ],
      "properties": {
        "OrderItems": {
          "$ref": "#/$defs/OrderItemBuyerInfoList"
        },
        "NextToken": {
          "type": "string",
          "description": "When present and not empty, pass this string token in the next request to return the next response page."
        },
        "AmazonOrderId": {
          "type": "string",
          "description": "An Amazon-defined order identifier, in 3-7-7 format."
        }
      },
      "description": "A single order item's buyer information list with the order ID."
    }
  }
}