Developer Console

Available Amazon Data Portability LWA Scopes

The Available Amazon Data Portability LWA Scopes defines the supported type of data that the customer is authorizing to give access to your Application.

Scopes are divided in two categories, Category-1 and Category-2, based on the type of the customer data in each scope.

Category-1 Scopes

To gain access to Category-1 scopes, you will complete the business identity verification in Step 2. Identity and security assessment.

Customer Profile

This scope includes Amazon customer's profile information like profile photo, cover photo, bio, and configured privacy settings.

Identifiers:

  • Login with Amazon Scope Name: portability::customer_profile
  • Amazon Data Portability scopeId: portability-customer-profile

Customer profile

Schema properties:

Properties Details Example value
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
images The customer's avatar and cover photos. N/A
images.url The image url. https://images-fe.ssl-images-amazon.com/images/S/amazon-cover-photo/default._SX110_.png
images.type The image type. coverPhoto
privacySettings The privacy settings set in the Edit Privacy page to show or hide certain widgets or content created in the profile page. The values sometimes have a default value, and some of these settings are deprecated or could be a feature that's not available in all marketplaces. N/A
privacySettings.activityOnYourProfileVisibility The visibility of the activity timeline. public
privacySettings.sensitiveActivityVisibility The visibility of sensitive items. public
privacySettings.babyRegistryVisibility The visibility of the baby registry. private
privacySettings.topReviewerBadgesVisibility The visibility of the top reviewer badge. public
privacySettings.topContributorStatusVisibility The visibility of the top contributor status. private
privacySettings.whoYouFollowVisibility The visibility of the list of entities a customer follows. private
privacySettings.publicWishListVisibility The visibility of the public wishlist. public
privacySettings.reviewsVisibility The visibility of the reviews. public
privacySettings.weddingRegistryVisibility The visibility of the wedding registry. private
profileAttributes The profile attributes. N/A
profileAttributes.location The location. Germany
profileAttributes.publicName The name set on the profile page. John Doe
profileAttributes.bio The bio. Professional Tester
profileAttributes.occupation The occupation. QA Engineer
profileAttributes.website The website. www.personal-website.com
profileAttributes.facebookLink The link to the Facebook account. https://www.facebook.com/username
profileAttributes.pinterestLink The link to the Pinterest account. https://pinterest.com/username
profileAttributes.twitterLink The link to the Twitter account. https://www.twitter.com/username
profileAttributes.instagramLink The link to the Instagram account. https://www.instagram.com/username
profileAttributes.youtubeLink The link to the YouTube account. https://www.youtube.com/channel/channel

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Customer Profile",
  "description": "Includes customer profile information, such as profile photo, cover photo, bio or customer-configured privacy settings.",
  "type": "object",
  "unevaluatedProperties": false,
  "properties": {
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "images": {
      "description": "The customer's profile and cover photos.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The image url (e.g., https://images-fe.ssl-images-amazon.com/images/S/amazon-cover-photo/default._SX110_.png)."
          },
          "type": {
            "description": "The image type (e.g., coverPhoto).",
            "type": "string",
            "enum": [
              "coverPhoto",
              "profilePhoto"
            ]
          }
        },
        "required": [
          "url",
          "type"
        ],
        "unevaluatedProperties": false
      }
    },
    "privacySettings": {
      "description": "The privacy settings set in the Edit Privacy page to show or hide certain widgets or content created in the profile page. The values sometimes have a default value, and some of these settings are deprecated or could be a feature that's not available in all marketplaces.",
      "type": "object",
      "properties": {
        "activityOnYourProfileVisibility": {
          "description": "The visibility of the activity timeline (e.g., public).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "sensitiveActivityVisibility": {
          "description": "The visibility of sensitive items (e.g., public).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "babyRegistryVisibility": {
          "description": "The visibility of the baby registry (e.g., private).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "topReviewerBadgesVisibility": {
          "description": "The visibility of the top reviewer badge (e.g., public).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "topContributorStatusVisibility": {
          "description": "The visibility of the top contributor status (e.g., private).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "whoYouFollowVisibility": {
          "description": "The visibility of the list of entities a customer follows (e.g., private).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "publicWishListVisibility": {
          "description": "The visibility of the public wishlist (e.g., public).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "reviewsVisibility": {
          "description": "The visibility of the reviews (e.g., public).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "weddingRegistryVisibility": {
          "description": "The visibility of the wedding registry (e.g., private).",
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        },
        "unevaluatedProperties": false
      }
    },
    "profileAttributes": {
      "description": "The profile attributes.",
      "type": "object",
      "properties": {
        "location": {
          "description": "The location (e.g., Germany).",
          "type": "string"
        },
        "publicName": {
          "description": "The name set on the profile page (e.g., John Doe).",
          "type": "string"
        },
        "bio": {
          "description": "The bio (e.g., Professional Tester).",
          "type": "string"
        },
        "occupation": {
          "description": "The occupation (e.g., QA Engineer).",
          "type": "string"
        },
        "website": {
          "description": "The website (e.g., www.personal-website.com).",
          "type": "string"
        },
        "facebookLink": {
          "description": "The link to the facebook account (e.g., https://www.facebook.com/username).",
          "type": "string"
        },
        "pinterestLink": {
          "description": "The link to the pinterest account (e.g., https://pinterest.com/username).",
          "type": "string"
        },
        "twitterLink": {
          "description": "The link to the twitter account (e.g., https://www.twitter.com/username).",
          "type": "string"
        },
        "instagramLink": {
          "description": "The link to the instagram account (e.g., https://www.instagram.com/username).",
          "type": "string"
        },
        "youtubeLink": {
          "description": "The link to the youtube account (e.g., https://www.youtube.com/channel/channel).",
          "type": "string"
        }
      },
      "required": [
        "publicName"
      ],
      "unevaluatedProperties": false
    }
  },
  "required": [
    "eventDate",
    "profileAttributes"
  ]
}

Sample data based on the sample schema:

{
  "eventDate": "2021-09-29T11:04:43.305Z",
  "images": [
    {
      "url": "https://images-fe.ssl-images-amazon.com/images/S/amazon-cover-photo/default._SX110_.png",
      "type": "coverPhoto"
    }
  ],
  "privacySettings": {
    "activityOnYourProfileVisibility": "public",
    "sensitiveActivityVisibility": "public",
    "babyRegistryVisibility": "private",
    "topReviewerBadgesVisibility": "public",
    "topContributorStatusVisibility": "private",
    "whoYouFollowVisibility": "private",
    "publicWishListVisibility": "public",
    "reviewsVisibility": "public",
    "weddingRegistryVisibility": "private"
  },
  "profileAttributes": {
    "location": "Germany",
    "publicName": "John Doe",
    "bio": "Professional Tester",
    "occupation": "QA Engineer",
    "website": "www.personal-website.com",
    "facebookLink": "https://www.facebook.com/username",
    "pinterestLink": "https://pinterest.com/username",
    "twitterLink": "https://www.twitter.com/username",
    "instagramLink": "https://www.instagram.com/username",
    "youtubeLink": "https://www.youtube.com/channel/channel"
  }
}

Product reviews

This scope includes Amazon customer's product reviews with details like text, photos, videos, and star ratings.

Identifiers:

  • Login with Amazon Scope Name: portability::product_reviews
  • Amazon Data Portability scopeId: portability-product-reviews

Product reviews

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
asin The identifier of the reviewed product, a unique ten-digit alphanumeric code. B08FXVRFL9
versionID The sequential identifier for the review version. 3
imageURLs The URL of the images uploaded and stored in the Amazon systems. https://m.media-amazon.com/images/I/61dJstwX20L._SL1600_.jpg
videoURLs The URL of the video uploaded and stored in the Amazon systems. https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4
starRating The numeric rating value in the range of 1-5. It relates to the number of stars assigned to the product. 5
text The text part of the review. Pretty good puzzle
title The title of the review. Recommended
featureRatings The list of pairs of product attributes with the numeric rating value in reference to the product. Flavor:4
status The status of the review. approved

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Product Reviews",
  "type": "array",
  "description": "Includes product reviews provided by the customer, with details such as the review text, image references, video references and rating insights.",
  "items": {
    "type": "object",
    "description": "Review contents",
    "properties": {
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "pattern": "^[A-Z]{2}$"
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "asin": {
        "type": "string",
        "description": "The identifier of the reviewed product, a unique ten-digit alphanumeric code (e.g., B08FXVRFL9)."
      },
      "versionID": {
        "type": "integer",
        "description": "The sequential identifier for the review version. (e.g., 3)."
      },
      "imageURLs": {
        "type": "array",
        "description": "The URL of the images uploaded and stored in the Amazon systems. (e.g., https://m.media-amazon.com/images/I/61dJstwX20L._SL1600_.jpg).",
        "items": {
          "type": "string"
        }
      },
      "videoURLs": {
        "type": "array",
        "description": "The URL of the video uploaded and stored in the Amazon systems (e.g., https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4).",
        "items": {
          "type": "string"
        }
      },
      "starRating": {
        "type": "integer",
        "description": "The numeric rating value in the range of 1-5. It relates to the number of stars assigned to the product (e.g., 5)."
      },
      "text": {
        "type": "string",
        "description": "The text part of the review (e.g., Pretty good puzzle)."
      },
      "title": {
        "type": "string",
        "description": "The title of the review (e.g., Recommended)."
      },
      "featureRatings": {
        "type": "array",
        "description": "The list of pairs of product attributes with the numeric rating value in reference to the product (e.g., Flavor:4).",
        "items": {
          "type": "string"
        }
      },
      "status": {
        "type": "string",
        "description": "The status of the review (e.g., approved)."
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "asin",
      "versionID"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "asin": "B08FXVRFL9",
    "versionID": 3,
    "imageURLs": [
      "https://m.media-amazon.com/images/I/61dJstwX20L._SL1600_.jpg"
    ],
    "videoURLs": [
      "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4"
    ],
    "starRating": 5,
    "text": "Pretty good puzzle",
    "title": "Recommended",
    "featureRatings": [
      "Flavor:4"
    ],
    "status": "approved"
  }
]

Seller feedback

This scope includes Amazon customer's feedback provided to third-party sellers, including details like feedback text, ratings, and customer selected reason codes.

Identifiers:

  • Login with Amazon Scope Name: portability::seller_feedback
  • Amazon Data Portability scopeId: portability-seller-feedback

Seller feedback

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
feedbackDate The date when the feedback was given, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
feedbackRating The star rating provided by the customer. 1
feedbackText The feedback text provided by the customer. Lorem Ipsum
dealAgain The customer provided response stating if they will purchase from the seller again. true
itemArrivedOnTime The customer provided response stating if the item arrived on time. true
promptOnCorteousService The customer provided response stating if the communication from the seller was good. false
itemAsDescribed The customer provided response stating if the item was received as described by the seller. true
whatWentWrong The customer selected reason code indicating which issue they had with their order. Wrong Version or Size

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Seller Feedback",
  "description": "Includes feedback provided by the customer to the third-party sellers, including details such as feedback text, ratings, and customer selected reason codes. ",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "type": "string"
      },
      "eventDate": {
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "feedbackDate": {
        "description": "The date when the feedback was given, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "feedbackRating": {
        "description": "The star rating provided by the customer (e.g., 4).",
        "enum": [
          1,
          2,
          3,
          4,
          5
        ]
      },
      "feedbackText": {
        "description": "The feedback text provided by the customer (e.g., Lorem Ipsum).",
        "type": "string"
      },
      "dealAgain": {
        "description": "The customer provided response stating if they will purchase from the seller again (e.g., true).",
        "type": "boolean"
      },
      "itemArrivedOnTime": {
        "description": "The customer provided response stating if the item arrived on time (e.g., true).",
        "type": "boolean"
      },
      "promptCourteousService": {
        "description": "The customer provided response stating if the communication from the seller was good (e.g., false).",
        "type": "boolean"
      },
      "itemAsDescribed": {
        "description": "The customer provided response stating if the item was received as described by the seller (e.g., true).",
        "type": "boolean"
      },
      "whatWentWrong": {
        "enum": [
          "Completely Wrong Item",
          "Damaged Defective Other",
          "Did not receive my package",
          "Due to poor packaging",
          "Issue Not Listed Above",
          "Item Not As Described",
          "Just Not Happy With My Product",
          "Received my package late",
          "Return or Refund Issue",
          "Something was missing",
          "Wrong Version or Size"
        ],
        "description": "The customer selected reason code indicating which issue they had with their order (e.g., Wrong Version or Size)."
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "feedbackDate",
      "feedbackRating"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "feedbackDate": "2021-09-29T11:04:43.305Z",
    "feedbackRating": 1,
    "feedbackText": "Reliable shop",
    "dealAgain": true,
    "itemArrivedOnTime": true,
    "promptCourteousService": false,
    "itemAsDescribed": true,
    "whatWentWrong": "Wrong Version or Size"
  }
]

Category-2 Scopes

To gain access to Category-2 scopes, you will complete the business identity and data security verification in Step 2. Identity and security assessment.

Advertising preferences and clicked ads

This scope includes details about Amazon customers’ clicked ads and whether they have opted out of interest based advertising.

Identifiers:

  • Login with Amazon Scope Name: portability::advertising_insights
  • Amazon Data Portability scopeId : portability-advertising-insights

Advertising clicks

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
advertiserName The name of the advertiser that owns the ad which was clicked by the customer. MF Network Tech

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Advertising - Clicks",
  "description": "Includes details about ads clicked by the customer.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "advertiserName": {
        "type": "string",
        "description": "The name of the advertiser that owns the ad which was clicked by the customer (e.g., MF Network Tech)."
      },
      "marketplace": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "advertiserName",
      "marketplace",
      "eventDate"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "advertiserName": "MF Network Tech"
  }
]

Advertising interest based opt outputs

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
isOptedOut The flag that specifies whether the customer has opted out of interest based advertising. false

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Advertising - Interest Based Opt Outs",
  "description": "Includes details about the customer's interest based advertising opt out status.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "isOptedOut": {
        "type": "boolean",
        "description": "The flag that specifies whether the customer has opted out of interest based advertising (e.g., false)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "marketplace": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "marketplace",
      "isOptedOut",
      "eventDate"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "isOptedOut": false
  }
]

Alexa shopping lists

This scope includes Amazon customer's Alexa digital grocery shopping lists with details like name, type, and origin of recipe.

Identifiers:

  • Login with Amazon Scope Name: portability::alexa_shopping_lists
  • Amazon Data Portability scopeId : portability-alexa-shopping-lists

Alexa shopping lists

Schema properties:

Properties Details Example value
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
listName The name of the shopping list. My Shopping List
listType The type of the shopping list. SHOP
listItems The items in the shopping list. N/A
listItems.itemName The name of the item in the list. cake
listItems.isCompleted The flag that specifies if the item is completed. false
isArchived The flag that specifies if the list is archived. false
sourceUrl The source URL of the recipe. www.recipes.com

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Alexa Shopping Lists",
  "type": "array",
  "description": "Includes the digital grocery shopping lists created by the customer, with details such as name, type or origin of a recipe, if applicable.",
  "items": {
    "type": "object",
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "listName": {
        "type": "string",
        "description": "The name of the shopping list (e.g., My Shopping List)."
      },
      "listType": {
        "type": "string",
        "description": "The type of the shopping list (e.g., SHOP).",
        "enum": [
          "SHOP",
          "TODO",
          "CUSTOM",
          "RECIPE",
          "RECIPE_DEF"
        ]
      },
      "listItems": {
        "type": "array",
        "description": "The items in the shopping list.",
        "items": {
          "type": "object",
          "properties": {
            "itemName": {
              "type": "string",
              "description": "The name of the item in the list (e.g., cake)."
            },
            "isCompleted": {
              "type": "boolean",
              "description": "The flag that specifies if the item is completed (e.g., false)."
            }
          },
          "required": [
            "itemName",
            "isCompleted"
          ],
          "unevaluatedProperties": false
        }
      },
      "isArchived": {
        "type": "boolean",
        "description": "The flag that specifies if the list is archived (e.g., false)."
      },
      "sourceUrl": {
        "type": "string",
        "description": "The source URL of the recipe (e.g., www.recipes.com)."
      }
    },
    "required": [
      "eventDate",
      "listName",
      "listType",
      "isArchived"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "eventDate": "2021-09-29T11:04:43.305Z",
    "listName": "My Shopping List",
    "listType": "SHOP",
    "isArchived": false,
    "listItems": [
      {
        "itemName": "cake",
        "isCompleted": false
      }
    ],
    "sourceUrl": "www.recipes.com"
  }
]

Confirmed fit device selections

This scope includes customer's confirmed fit device model selections with details like their category and series.

Identifiers:

  • Login with Amazon Scope Name: portability::confirmed_fit_selections
  • Amazon Data Portability scopeId : portability-confirmed-fit-selections

Confirmed fit device selections

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
scope The category of the device. ink_toner
normalizedSeries The series of the device. LASERJET
normalizedModel The model of the device. WF-7720DTWF
userSavedNormalizedBrand The brand of the device. EPSON

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Confirmed Fit Device Selections",
  "description": "Includes customer's confirmed fit device model selections, with details such as their category and series.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "scope": {
        "description": "The category of the device (e.g., ink_toner).",
        "type": "string"
      },
      "normalizedSeries": {
        "description": "The series of the device (e.g., LASERJET).",
        "type": "string"
      },
      "normalizedModel": {
        "description": "The model of the device (e.g., WF-7720DTWF).",
        "type": "string"
      },
      "userSavedNormalizedBrand": {
        "description": "The brand of the device (e.g., EPSON).",
        "type": "string"
      },
      "marketplace": {
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "pattern": "^[A-Z]{2}$",
        "type": "string"
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "userSavedNormalizedBrand",
      "normalizedModel",
      "scope"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "scope": "ink_toner",
    "normalizedModel": "WF-7720DTWF",
    "normalizedSeries": "LASERJET",
    "userSavedNormalizedBrand": "EPSON"
  }
]

Contact information

This scope includes Amazon customer's contact information like email and phone number.

Identifiers:

  • Login with Amazon Scope Name: portability::contact_information
  • Amazon Data Portability scopeId : portability-contact-information

Contact information

Schema properties:

Properties Details Example value
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
communicationMedium The medium of communication like sms, voice, email. SMS
email The email of the user. nobody@amazon.com
countryCode The country code of phone number of the user formatted according to ISO 3166-1 alpha-2 standard. DE
extension The extension of phone number of the user. +49
localPhoneNumber The phone number of the user. 123456789

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Contact Information",
  "description": "Includes the contact information configured by the customer, such as email or phone number.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "communicationMedium": {
        "description": "The medium of communication like (e.g., SMS, VOICE, EMAIL).",
        "type": "string"
      },
      "email": {
        "description": "The email of the user (e.g., nobody@amazon.com).",
        "type": "string"
      },
      "countryCode": {
        "description": "The country code of phone number of the user formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "type": "string"
      },
      "extension": {
        "description": "The extension of phone number of the user (e.g., +49).",
        "type": "string"
      },
      "localPhoneNumber": {
        "description": "The phone number of the user (e.g., 123456789).",
        "type": "string"
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      }
    },
    "anyOf": [
      {
        "required": [
          "communicationMedium",
          "email",
          "eventDate"
        ]
      },
      {
        "required": [
          "communicationMedium",
          "localPhoneNumber",
          "eventDate"
        ]
      }
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "eventDate": "2021-09-29T11:04:43.305Z",
    "communicationMedium": "SMS",
    "countryCode": "DE",
    "extension": "+49",
    "localPhoneNumber": "123456789"
  }
]

Custom products

This scope includes Amazon customer's list of customized products with details like product name and personalized text.

Identifiers:

  • Login with Amazon Scope Name: portability::custom_products
  • Amazon Data Portability scopeId : portability-custom-products

Custom products

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
orderId The order identifier of the product purchased by the customer, populated only if source is ORDER. 112-3701535-1629840
sourceId The identifier of the source containing the item. Saved for later
source The source of this record. CART
asin The identifier of the product that the customer added to their lists, cart or purchased, a unique ten-digit alphanumeric code. B0B8DTFX3F
productName The product title that the customer added to their lists, carts or purchased. Personalized Coffee Mug - Add text to our Custom Mugs
customizations The customization list provided by the customer. N/A
customizations.textInputs The list of text customizations provided by the customer. Mason Manor, Georgia

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Custom Products",
  "description": "Includes list of customized products, with details such as product name and customization text.",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "source",
      "eventDate",
      "asin",
      "productName",
      "marketplace",
      "customizations"
    ],
    "properties": {
      "source": {
        "description": "The source of this record (e.g., CART).",
        "type": "string"
      },
      "eventDate": {
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string"
      },
      "asin": {
        "description": "The identifier of the product that the customer added to their lists, cart or purchased, a unique ten-digit alphanumeric code (e.g., B0B8DTFX3F).",
        "type": "string"
      },
      "productName": {
        "description": "The product title that the customer added to their lists, carts or purchased (e.g., Personalized Coffee Mug - Add text to our Custom Mugs)",
        "type": "string"
      },
      "marketplace": {
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "pattern": "^[A-Z]{2}$",
        "type": "string"
      },
      "customizations": {
        "description": "The customization list provided by the customer.",
        "type": "object",
        "properties": {
          "textInputs": {
            "description": "The list of text customizations provided by the customer (e.g., Mason Manor, Georgia).",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "oneOf": [
      {
        "properties": {
          "orderId": {
            "description": "The order identifier of the product purchased by the customer, populated only if source is ORDER (e.g., 112-3701535-1629840).",
            "type": "string"
          }
        },
        "required": [
          "orderId"
        ]
      },
      {
        "properties": {
          "sourceId": {
            "description": "The identifier of the source containing the item (e.g., Saved for later).",
            "type": "string"
          }
        },
        "required": [
          "sourceId"
        ]
      }
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "source": "CART",
    "sourceId": "Saved for later",
    "asin": "B0B8DTFX3F",
    "productName": "Personalized Coffee Mug - Add text to our Custom Mugs",
    "customizations": {
      "textInputs": [
        "Mason Manor",
        "Georgia"
      ]
    }
  }
]

Customer attributes

This scope includes Amazon customer's personal attributes like nickname, gender, and language of preference.

Identifiers:

  • Login with Amazon Scope Name: portability::customer_attributes
  • Amazon Data Portability scopeId : portability-customer-attributes

Customer attributes

Schema properties:

Properties Details Example value
nickname The configured nickname. Peanut
gender The configured gender. Male
languagePreferences The configured list of language of preferences. en_GB

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Customer Attributes",
  "description": "Includes personal attributes configured by the customer, such as nickname, gender or language of preference.",
  "type": "object",
  "items": {
    "type": "object",
    "properties": {
      "nickname": {
        "description": "The configured nickname (e.g., Peanut).",
        "type": "array"
      },
      "gender": {
        "description": "The configured gender (e.g., Male).",
        "type": "string"
      },
      "languagePreferences": {
        "description": "The configured list of language of preferences (e.g., en_GB).",
        "type": "array"
      }
    },
    "required": [
      "gender"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

{
  "nickname": "Peanut",
  "gender": "Male",
  "languagePreferences": "en_GB"
}

Digital order returns

This scope includes Amazon customer's digital orders that were refunded and their associated refund transactions.

Identifiers:

  • Login with Amazon Scope Name: portability::digital_order_returns
  • Amazon Data Portability scopeId : portability-digital-order-returns

Digital order returns transactions

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
orderId The identifier of the digital order for which the return was initiated. D01-2832465-7013023
title The title of the product that was purchased. Prime Membership Fee
amountRefunded The amount that was refunded to the customer. 3.99
baseCurrencyCode The currency code of the transaction formatted according to ISO 4217 standard. EUR
productName The product title that the customer added to their lists, carts or purchased. Personalized Coffee Mug - Add text to our Custom Mugs

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Order Returns - Transactions",
  "description": "Includes the list of digital transactions that were refunded by Amazon to the customer.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "orderId": {
        "type": "string",
        "description": "The identifier of the digital order for which the return was initiated (e.g., D01-2832465-7013023)."
      },
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "title": {
        "type": "string",
        "description": "The title of the product that was purchased (e.g., Prime Membership Fee)."
      },
      "amountRefunded": {
        "description": "The amount that was refunded to the customer (e.g., 3.99).",
        "type": "string"
      },
      "baseCurrencyCode": {
        "type": "string",
        "description": "The currency code of the transaction formatted according to ISO 4217 standard (e.g., EUR)."
      }
    },
    "required": [
      "orderId",
      "marketplace",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "orderId": "D01-2832465-7013023",
    "title": "Prime Membership Fee",
    "amountRefunded": "3.99",
    "baseCurrencyCode": "EUR"
  }
]

Digital order returns monetary

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
orderId The identifier of the digital order for which the return was initiated. D01-2832465-7013023
quantity The number of items that have been returned. 2
reasonCode The reason code for the return. UNWANTED
baseCurrencyCode The currency code of the transaction formatted according to ISO 4217 standard. EUR
transactionAmount The amount that was refunded. 3.99
baseCurrencyCode The currency code of the transaction formatted according to ISO 4217 standard. EUR

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Order Returns - Monetary",
  "description": "Includes the list of refund transactions initiated by Amazon to the customer.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "orderId": {
        "type": "string",
        "description": "The identifier of the digital order for which the return was initiated (e.g., D01-2842565-8013723)."
      },
      "quantity": {
        "description": "The number of items that have been returned (e.g., 2).",
        "type": "number"
      },
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "reasonCode": {
        "description": "The reason code for the return (e.g., UNWANTED).",
        "type": "string",
        "enum": [
          "WRONG_ITEM",
          "BETTER_PRICE",
          "QUALITY",
          "INCOMPATIBLE",
          "DOWNLOAD_PROBLEM",
          "LATE_DELIVERY",
          "DEFECTIVE",
          "UNWANTED",
          "DIGITAL_RIGHTS_RESTRICTIONS",
          "OTHER",
          "ACCIDENTAL_PURCHASE",
          "INTERNAL_RETURN",
          "OFFENSIVE_CONTENT",
          "FAILED_EXTERNAL_INVOICE",
          "EXCHANGE_UPGRADE_DOWNGRADE",
          "SUBSCRIPTION_CANCELLATION"
        ]
      },
      "transactionAmount": {
        "description": "The amount that was refunded (e.g., 3.99).",
        "type": "string"
      },
      "baseCurrencyCode": {
        "type": "string",
        "description": "The currency code of the transaction formatted according to ISO 4217 standard (e.g., EUR)."
      }
    },
    "required": [
      "orderId",
      "quantity",
      "reasonCode",
      "eventDate",
      "marketplace"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "orderId": "D01-2832465-7013023",
    "quantity": 2,
    "reasonCode": "UNWANTED",
    "transactionAmount": "3.99",
    "baseCurrencyCode": "EUR"
  }
]

Digital orders

This scope includes Amazon customer's digital order history with details like product name, prices paid, and quantity ordered.

Identifiers:

  • Login with Amazon Scope Name: portability::digital_orders
  • Amazon Data Portability scopeId : portability-digital-orders

Digital orders items

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
baseCurrencyCode The currency code for the item price, formatted according to ISO 4217 standard. EUR
digitalOrderItemId The identifier of the item from the order. CLCQKDL52GAHOP93C5I4FT0IPKV77D74HBD4SUCHAF7
installmentOurPrice The price of the installment, if it is an installment order. 1.14
installmentOurPriceCurrencyCode The currency code for the installment order, formatted according to ISO 4217 standard. EUR
quantityOrdered The quantity the item was ordered. 1
title The title of the item. Paramount+
giftItem The flag that marks if the item was purchased as a gift. false
isOrderEligibleForPrimeBenefit The flag that marks if the order is eligible for prime benefits. Yes

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Orders - Items",
  "description": "Includes customer's digital order history items with details like product names, prices paid and quantity ordered.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "baseCurrencyCode": {
        "type": "string",
        "description": "The currency code for the item price, formatted according to ISO 4217 standard (e.g., EUR)."
      },
      "digitalOrderItemId": {
        "type": "string",
        "description": "The identifier of the item from the order (e.g., CLCQKDL52GAHOP93C5I4FT0IPKV77D74HBD4SUCHAF7)."
      },
      "installmentOurPrice": {
        "type": "string",
        "description": "The price of the installment, if it is an installment order (e.g., 1.14)."
      },
      "installmentOurPriceCurrencyCode": {
        "type": "string",
        "description": "The currency code for the installment order, formatted according to ISO 4217 standard (e.g., EUR)."
      },
      "quantityOrdered": {
        "type": "number",
        "description": "The quantity the item was ordered (e.g., 2)."
      },
      "title": {
        "type": "string",
        "description": "The title of the item (e.g., Paramount+)."
      },
      "giftItem": {
        "type": "boolean",
        "description": "The flag that marks if the item was purchased as a gift (e.g., true)."
      },
      "isOrderEligibleForPrimeBenefit": {
        "description": "The flag that marks if the order is eligible for prime benefits (e.g., Yes).",
        "type": "string",
        "enum": [
          "Yes",
          "No"
        ]
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "baseCurrencyCode",
      "digitalOrderItemId",
      "quantityOrdered",
      "giftItem"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "FR",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "baseCurrencyCode": "EUR",
    "digitalOrderItemId": "CLCQKDL52GAHOP93C5I4FT0IPKV77D74HBD4SUCHAF7",
    "installmentOurPrice": "1.14",
    "installmentOurPriceCurrencyCode": "EUR",
    "quantityOrdered": 1,
    "title": "Paramount+",
    "giftItem": true,
    "isOrderEligibleForPrimeBenefit": "Yes"
  }
]

Digital orders history

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
orderId The unique identifier for a digital order which the product belongs to. D01-4762016-7053852
isOrderAPreorder The flag that marks if a digital order was a pre-order. false
orderStatus The status code describing the order status. SUCCESS
relatedPhysicalOrderId The related physical order identifier, if it exists. 111-5645993-5749423
subscriptionOrderType The type of the order if it is a subscription. Subscription_Renewal

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Orders - History",
  "description": "Includes customer's digital order history, with details like order status and whether it relates to a subscription.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "orderId": {
        "type": "string",
        "description": "The unique identifier for a digital order which the product belongs to (e.g., D01-4762016-7053852)."
      },
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "isOrderAPreorder": {
        "description": "The flag that marks if a digital order was a pre-order (e.g., false).",
        "type": "boolean"
      },
      "orderStatus": {
        "description": "The status code describing the order status (e.g., SUCCESS).",
        "type": "string",
        "enum": [
          "PENDING",
          "CANCELLED_BY_AMAZON",
          "PENDING_PREORDER_RELEASE",
          "COMBINED_WITH_SIMILAR_ORDER",
          "USER_CANCELED",
          "N/A",
          "SUCCESS"
        ]
      },
      "relatedPhysicalOrderId": {
        "type": "string",
        "description": "The related physical order identifier, if it exists. (e.g., 111-5645993-5749423)."
      },
      "subscriptionOrderType": {
        "type": "string",
        "description": "The type of the order if it is a subscription (e.g., Subscription_Renewal)."
      }
    },
    "required": [
      "orderId",
      "marketplace",
      "eventDate",
      "isOrderAPreorder",
      "orderStatus"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "orderId": "D01-4762016-7053852",
    "isOrderAPreorder": false,
    "orderStatus": "SUCCESS",
    "relatedPhysicalOrderId": "111-5645993-5749423",
    "subscriptionOrderType": "Subscription_Renewal"
  }
]

Digital orders monetary

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
deliveryPacketId The identifier of the delivery packet, corresponding to a processed item. GE0VRELSG8IJNJRAH6T6VB3PILHPIG0LCRKGHKJMD5SDG
transactionAmount The monetary amount of the transaction. 2.95
affectedItemQuantity The quantity of the item. 5
fxCurrencyCode The foreign exchange currency code for the item price, formatted according to ISO 4217 standard. EUR
fxTransactionAmount The foreign exchange transaction amount. 1.17
digitalOrderItemId The identifier of the item in the order. VNCG8HRN6AU4I3HSIICNJL8RQU4IKODO816N05FHJ170PQGUJIDG
baseCurrencyCode The currency code for the item price, formatted according to ISO 4217 standard. EUR
monetaryComponentTypeCode The type of the transaction. Price Amount

Schema Sample

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Orders - Monetary",
  "description": "Includes customer's digital order history monetary information about each ordered item.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "format": "date-time"
      },
      "deliveryPacketId": {
        "type": "string",
        "description": "The identifier of the delivery packet, corresponding to a processed item (e.g., GE0VRELSG8IJNJRAH6T6VB3PILHPIG0LCRKGHKJMD5SDG)."
      },
      "transactionAmount": {
        "type": "number",
        "description": "The monetary amount of the transaction (e.g., 2.95)."
      },
      "affectedItemQuantity": {
        "type": "number",
        "description": "The quantity of the item (e.g., 5)."
      },
      "fxCurrencyCode": {
        "type": "string",
        "description": "The foreign exchange currency code for the item price, formatted according to ISO 4217 standard (e.g., EUR)."
      },
      "fxTransactionAmount": {
        "type": "string",
        "description": "The foreign exchange transaction amount (e.g., 1.17)."
      },
      "digitalOrderItemId": {
        "type": "string",
        "description": "The identifier of the item in the order (e.g., VNCG8HRN6AU4I3HSIICNJL8RQU4IKODO816N05FHJ170PQGUJIDG)."
      },
      "baseCurrencyCode": {
        "type": "string",
        "description": "The currency code for the item price, formatted according to ISO 4217 standard (e.g., EUR)."
      },
      "monetaryComponentTypeCode": {
        "type": "string",
        "description": "The type of the transaction (e.g., Price Amount)."
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "deliveryPacketId",
      "affectedItemQuantity",
      "digitalOrderItemId"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "deliveryPacketId": "GE0VRELSG8IJNJRAH6T6VB3PILHPIG0LCRKGHKJMD5SDG",
    "transactionAmount": 2.95,
    "affectedItemQuantity": 5,
    "fxCurrencyCode": "EUR",
    "fxTransactionAmount": "1.17",
    "digitalOrderItemId": "VNCG8HRN6AU4I3HSIICNJL8RQU4IKODO816N05FHJ170PQGUJIDG",
    "baseCurrencyCode": "EUR",
    "monetaryComponentTypeCode": "Price Amount"
  }
]

Digital redemptions

This scope includes Amazon customer's digital redemptions that were claimed as a gift certificate or a gift item.

Identifiers:

  • Login with Amazon Scope Name: portability::digital_redemptions
  • Amazon Data Portability scopeId : portability-digital-redemptions

Digital redemptions

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
customerRole The role of the customer as part of which the redemption was created. Sender
orderId The unique identifier of the digital order as part of which this redemption was created. D01-6692487-8533455
title The title of the gift item. An Accidental Headship
contentType The type of the content of the gift item. eBook
ourPriceAmount The price of the gift item. 3.99
ourPriceCurrencyCode The currency code for the price amount, formatted according to ISO 4217 standard. EUR

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Redemptions",
  "description": "Includes the list of redemptions claimed by the customer as a gift certificate or gift item that may be purchased by the same or by a different customer.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string"
      },
      "customerRole": {
        "description": "The role of the customer as part of which the redemption was created (e.g., Sender).",
        "type": "string",
        "enum": [
          "Sender",
          "Sender and Recipient",
          "Recipient (Sender data removed to protect sender's privacy)"
        ]
      },
      "orderId": {
        "type": "string",
        "description": "The unique identifier of the digital order as part of which this redemption was created (e.g., D01-6692487-8533455)."
      },
      "title": {
        "type": "string",
        "description": "The title of the gift item (e.g., An Accidental Headship)."
      },
      "contentType": {
        "description": "The type of the content of the gift item (e.g., eBook).",
        "type": "string",
        "enum": [
          "Kindle Games & Active Content",
          "Mp3",
          "eBook",
          "Mobile Apps",
          "Amazon Local Voucher",
          "Amazon Coins",
          "Kindle Free Time Unlimited",
          "Prime",
          "Kindle Unlimited",
          "Music Unlimited"
        ]
      },
      "ourPriceAmount": {
        "description": "The price of the gift item (e.g., 3.99).",
        "type": "number"
      },
      "ourPriceCurrencyCode": {
        "type": "string",
        "description": "The currency code for the price amount, formatted according to ISO 4217 standard (e.g., EUR)."
      }
    },
    "required": [
      "marketplace",
      "customerRole",
      "contentType",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "customerRole": "Sender",
    "orderId": "D01-6692487-8533455",
    "contentType": "eBook",
    "title": "An Accidental Headship",
    "ourPriceAmount": 3.99,
    "ourPriceCurrencyCode": "EUR"
  }
]

Digital software and video games downloads

This scope includes Amazon customer's digital software and video games download history.

Identifiers:

  • Login with Amazon Scope Name: portability::dsv_downloads
  • Amazon Data Portability scopeId : portability-dsv-downloads

Digital software and video games downloads

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
title The product title that the customer purchased. Tribes: Ascend [Game Connect]
downloadHistoryState The status of the download. READY
downloadLastUpdateDate The date when the latest updates happened, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Software and Video Games - Downloads",
  "description": "Includes the list of digital software and video games downloads.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "pattern": "^[A-Z]{2}$",
        "type": "string"
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "title": {
        "description": "The product title that the customer purchased (e.g., Tribes: Ascend [Game Connect]).",
        "type": "string"
      },
      "downloadHistoryState": {
        "enum": [
          "READY",
          "IN_PROGRESS",
          "PAUSED",
          "CANCELLED",
          "COMPLETED",
          "ERROR",
          "CHECKSUM_ERROR",
          "USER_EXIT",
          "REBOOT",
          "REQ_UPGRADE",
          "QUIT_BEFORE_START",
          "CREATED",
          "DEACTIVATED"
        ],
        "description": "The status of the download (e.g., READY)."
      },
      "downloadLastUpdateDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the latest updates happened, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "title"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "title": "Tribes: Ascend [Game Connect]",
    "downloadHistoryState": "READY",
    "downloadLastUpdateDate": "2021-09-29T11:04:43.305Z"
  }
]

Digital software and video games entitlements

This scope includes Amazon customer's entitlements in regard to digital software and video games.

Identifiers:

  • Login with Amazon Scope Name: portability::dsv_entitlements
  • Amazon Data Portability scopeId : portability-dsv-entitlements

Digital software and video games entitlements

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
asin The identifier of the purchased product, a unique ten-digit alphanumeric code. B07SR13WVW
productName The name of the product that was purchased. PhotoPad Photo Editing and Image Editor
status The status of the entitlement. Active
entitlements The list of entitlements. N/A
entitlements.entitlementType The entitlement type. Product Code
entitlements.entitlementValue The entitlement value. 1234-4567-02

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Software and Video Games - Entitlements",
  "description": "Includes the list of entitlements in regards to digital software and video games.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "pattern": "^[A-Z]{2}$",
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string"
      },
      "asin": {
        "description": "The identifier of the purchased product, a unique ten-digit alphanumeric code (e.g., B07SR13WVW).",
        "type": "string"
      },
      "productName": {
        "description": "The name of the product that was purchased (e.g., PhotoPad Photo Editing and Image Editor).",
        "type": "string"
      },
      "status": {
        "enum": [
          "Active",
          "Revoked"
        ],
        "description": "The status of the entitlement (e.g., Active)."
      },
      "entitlements": {
        "type": "array",
        "description": "The list of entitlements.",
        "items": {
          "type": "object",
          "properties": {
            "entitlementType": {
              "type": "string",
              "description": "The entitlement type (e.g., Product Code)."
            },
            "entitlementValue": {
              "type": "string",
              "description": "The entitlement value (e.g., 1234-4567-02)."
            }
          },
          "unevaluatedProperties": false,
          "required": [
            "entitlementType",
            "entitlementValue"
          ]
        }
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "marketplace",
      "eventDate",
      "asin",
      "productName"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "asin": "B07SR13WVW",
    "productName": "PhotoPad Photo Editing and Image Editor",
    "status": "Active",
    "entitlements": [
      {
        "entitlementType": "Product Code",
        "entitlementValue": "1234-4567-02"
      }
    ]
  }
]

Digital software and video games subscriptions

This scope includes Amazon customer's digital software and video games subscriptions with details like their price, quantity, type auto-renewal, and expiration date.

Identifiers:

  • Login with Amazon Scope Name: portability::dsv_subscriptions
  • Amazon Data Portability scopeId : portability-dsv-subscriptions

Digital software and video games subscriptions

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
autoRenewalEnabled The flag that indicates whether the license will auto renew at the end of contract cycle. true
contractInterval The current contract period interval. MONTH
contractIntervalsRemaining The number of intervals left on the contract, updated after each billing cycle. 0
contractStartDate The date at which contract starts, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ) 2021-09-29T11:04:43.305Z
graceInterval The grace period interval for which the user is allowed to keep the subscription. MONTH
graceIntervalsRemaining The number of grace period intervals left on the contract, updated after each billing cycle. 1
kind The kind of purchase. REGISTRATION
lastUpdateDate The date when the record was last updated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
licenseCreationDate The date the license was created, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
licenseStatus The current status of the license. ACTIVATED
licenseType The type of license the customer purchased. SUBSCRIPTION
productTitle The product title that the customer purchased. Kaspersky VPN Secure Connection
purchaseConfirmationStatus The flag that indicates if purchase was confirmed with the vendor. SUCCESS
purchaseDate The date when the record was purchased, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
purchaseState The flag that indicates the current state of purchase. FULFILLED_OK
purchaseStatus The current status of the purchase. ACTIVE
purchaseType The type of purchase. SUBSCRIPTION
quantity The quantity of items purchased. 1
redemptionExpirationDate The date at which the redemption expires, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2022-09-29T11:04:43.305Z
redemptionStatus The flag that indicates whether the user redeemed his/her license. CLAIMED
state The flag that specifies if current state of the purchase is valid. VALID
unitPrice The price per unit of the product(s) in default currency. 23.95
username The identifier of user in the vendor system. user1
vendorName The current name of the vendor. Microsoft

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Software and Video Games - Subscriptions",
  "description": "Includes the list of digital software and video games subscriptions with details like their price, quantity, type, auto-renewal or expiration date.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string"
      },
      "productTitle": {
        "description": "The product title that the customer purchased (e.g., Kaspersky VPN Secure Connection).",
        "type": "string"
      },
      "purchaseStatus": {
        "description": "The current status of the purchase (e.g., ACTIVE).",
        "type": "string",
        "enum": [
          "ACTIVE",
          "CANCELLED"
        ]
      },
      "purchaseType": {
        "description": "The type of purchase (e.g., SUBSCRIPTION).",
        "type": "string"
      },
      "autoRenewalEnabled": {
        "description": "The flag that indicates whether the license will auto renew at the end of contract cycle (e.g., true).",
        "type": "boolean"
      },
      "licenseCreationDate": {
        "description": "The date the license was created, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "licenseStatus": {
        "description": "The current status of the license (e.g., ACTIVATED).",
        "type": "string",
        "enum": [
          "ACTIVATED",
          "UNASSIGNED",
          "REVOKED",
          "REDEEMED"
        ]
      },
      "contractStartDate": {
        "format": "date-time",
        "description": "The date at which contract starts, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string"
      },
      "redemptionExpirationDate": {
        "description": "The date at which the redemption expires, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2022-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "redemptionStatus": {
        "description": "The flag that indicates whether the user redeemed his/her license (e.g., CLAIMED).",
        "enum": [
          "UNCLAIMED",
          "CLAIMED"
        ]
      },
      "quantity": {
        "description": "The quantity of items purchased (e.g., 1).",
        "type": "number"
      },
      "unitPrice": {
        "description": "The price per unit of the product(s) in default currency (e.g., 23.95).",
        "type": "number"
      },
      "licenseType": {
        "description": "The type of license the customer purchased (e.g., SUBSCRIPTION).",
        "type": "string"
      },
      "contractInterval": {
        "description": "The current contract period interval (e.g., MONTH).",
        "enum": [
          "DAY",
          "MONTH",
          "YEAR"
        ]
      },
      "contractIntervalsRemaining": {
        "description": "The number of intervals left on the contract, updated after each billing cycle (e.g., 0).",
        "type": "number"
      },
      "graceInterval": {
        "description": "The grace period interval for which the user is allowed to keep the subscription (e.g., MONTH).",
        "enum": [
          "DAY",
          "MONTH",
          "YEAR"
        ]
      },
      "kind": {
        "description": "The kind of purchase (e.g., REGISTRATION).",
        "type": "string"
      },
      "graceIntervalsRemaining": {
        "description": "The number of grace period intervals left on the contract, updated after each billing cycle (e.g., 1).",
        "type": "number"
      },
      "vendorName": {
        "description": "The current name of the vendor (e.g., Microsoft).",
        "type": "string"
      },
      "purchaseDate": {
        "description": "The date when the record was purchased, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "lastUpdateDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was last updated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "purchaseConfirmationStatus": {
        "description": "The flag that indicates if purchase was confirmed with the vendor (e.g., SUCCESS).",
        "type": "string",
        "enum": [
          "SUCCESS",
          "OK",
          "FAILURE_PURCHASE_INVALID"
        ]
      },
      "purchaseState": {
        "description": "The flag that indicates the current state of purchase (e.g., FULFILLED_OK).",
        "type": "string",
        "enum": [
          "FULFILLED_OK",
          "UNREFUNDED",
          "REVOKED_FAILED",
          "REVOKED_OK",
          "ACTIVE",
          "FULFILLING",
          "FULFILLED"
        ]
      },
      "state": {
        "description": "The flag that specifies if current state of the purchase is valid (e.g., VALID).",
        "type": "string",
        "enum": [
          "VALID",
          "INVALID",
          "ACTIVE"
        ]
      },
      "username": {
        "description": "The identifier of user in the vendor system (e.g., user1).",
        "type": "string"
      }
    },
    "required": [
      "productTitle",
      "marketplace",
      "purchaseDate",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "productTitle": "Kaspersky VPN Secure Connection",
    "purchaseStatus": "ACTIVE",
    "purchaseType": "SUBSCRIPTION",
    "autoRenewalEnabled": true,
    "licenseCreationDate": "2022-09-29T11:04:43.305Z",
    "licenseStatus": "ACTIVATED",
    "contractStartDate": "2022-09-29T11:04:43.305Z",
    "redemptionExpirationDate": "2022-09-29T11:04:43.305Z",
    "redemptionStatus": "CLAIMED",
    "quantity": 1,
    "unitPrice": 23.95,
    "licenseType": "SUBSCRIPTION",
    "contractInterval": "MONTH",
    "contractIntervalsRemaining": 0,
    "graceInterval": "MONTH",
    "kind": "REGISTRATION",
    "graceIntervalsRemaining": 1,
    "vendorName": "Microsoft",
    "purchaseDate": "2021-09-29T11:04:43.305Z",
    "lastUpdateDate": "2021-09-29T11:04:43.305Z",
    "purchaseConfirmationStatus": "SUCCESS",
    "purchaseState": "FULFILLED_OK",
    "state": "VALID",
    "username": "user1"
  }
]

Digital subscription bills

This scope includes Amazon customer's digital subscription bills with details like currency, transaction amount, and cancellations.

Identifiers:

  • Login with Amazon Scope Name: portability::digital_subscription_bills
  • Amazon Data Portability scopeId : portability-digital-subscription-bills

Digital subscription bills

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
baseCurrencyCode The currency code for the transaction amount, formatted according to ISO 4217 standard. EUR
cancellationRequested The flag that marks if cancellation was requested for the transaction. true
subscriptionId The subscription id associated with the transaction. UI8H6PQE3BHLRLLGFI6G5A9GLI42T62RN96L54PUG4GJNBTPSLAG
totalTransactionAmount The total amount of the transaction. 7.99

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Subscription Bills",
  "description": "Includes digital subscription bills associated to the customer's account, with details such as currency, transaction amount or cancellations.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string"
      },
      "baseCurrencyCode": {
        "description": "The currency code for the transaction amount, formatted according to ISO 4217 standard (e.g., EUR).",
        "type": "string"
      },
      "cancellationRequested": {
        "description": "The flag that marks if cancellation was requested for the transaction (e.g., true).",
        "type": "boolean"
      },
      "subscriptionId": {
        "description": "The subscription id associated with the transaction (e.g., UI8H6PQE3BHLRLLGFI6G5A9GLI42T62RN96L54PUG4GJNBTPSLAG).",
        "type": "string"
      },
      "totalTransactionAmount": {
        "description": "The total amount of the transaction (e.g., 7.99).",
        "type": "string"
      }
    },
    "required": [
      "marketplace",
      "subscriptionId",
      "totalTransactionAmount",
      "baseCurrencyCode",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "baseCurrencyCode": "EUR",
    "cancellationRequested": true,
    "subscriptionId": "UI8H6PQE3BHLRLLGFI6G5A9GLI42T62RN96L54PUG4GJNBTPSLAG",
    "totalTransactionAmount": "7.99"
  }
]

Digital subscriptions

This scope includes Amazon customer's digital subscriptions, their status history, and the associated billing schedule.

Identifiers:

  • Login with Amazon Scope Name: portability::digital_subscriptions
  • Amazon Data Portability scopeId : portability-digital-subscriptions

Digital subscriptions

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
subscriptionId The unique identifier for the digital subscription. BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG
autorenew The flag that specifies whether the subscription will renew automatically at the next subscription period. true
serviceProvider The identifier for the Amazon business that vends the subscription benefit. Amazon Prime
baseCurrencyCode The currency code for the price, formatted according to ISO 4217 standard. EUR

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Subscriptions",
  "description": "Includes the list of digital subscriptions and details like auto-renewal, provider of the service or the currency used for billing.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "subscriptionId": {
        "type": "string",
        "description": "The unique identifier for the digital subscription (e.g., BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG)."
      },
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "autorenew": {
        "type": "boolean",
        "description": "The flag that specifies whether the subscription will renew automatically at the next subscription period (e.g., true)."
      },
      "serviceProvider": {
        "description": "The identifier for the Amazon business that vends the subscription benefit (e.g., Amazon Prime).",
        "type": "string",
        "enum": [
          "Amazon Prime Business Auto Top Up",
          "Audible",
          "Amazon Photos",
          "Prime Video Channels",
          "Prime Video",
          "Alexa Skillstore",
          "AMASS Gameday Client",
          "Amazon Family",
          "Amazon Rapids",
          "Amazon Student",
          "Amazon Prime",
          "Amazon Registry",
          "Audible Sleep",
          "Amazon DVD Rentals",
          "Amazon Digital Data Plan",
          "Amazon Kindle Newsstand",
          "Amazon Kindle Active Content",
          "Amazon Prime Fresh Free Trial",
          "Audible Education",
          "Blink Subscription",
          "Blink",
          "Preferred Buyers Club",
          "Campus",
          "Alexa Together",
          "Comixology",
          "Comixology Unlimited",
          "Amazon Music Unlimited",
          "Digital Software and Videogames",
          "Groceries",
          "Alexa Guard",
          "Amazon Halo",
          "IMdbPro",
          "FreeTime Unlimited",
          "Kindle Bookclubs",
          "Kindle Guru",
          "Kindle Scaling Game Day",
          "Kindle Unlimited",
          "Kindle Series",
          "Kindle Series Subscriptions",
          "Love Film Translation",
          "Mobile Appstore Developer",
          "Amazon AppStore",
          "Oprah's Book Club",
          "Amazon Cloud Cam",
          "Product Insurance Warranties",
          "Prime Fresh",
          "Prime Pantry",
          "Prime Stylist",
          "Prime Book Box",
          "Print Magazine",
          "Ring",
          "Funko",
          "Subscribe With Amazon",
          "Tempo",
          "Prime Wireless Plans"
        ]
      },
      "baseCurrencyCode": {
        "type": "string",
        "description": "The currency code for the price, formatted according to ISO 4217 standard (e.g., EUR)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      }
    },
    "required": [
      "subscriptionId",
      "marketplace",
      "eventDate",
      "serviceProvider",
      "baseCurrencyCode"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "subscriptionId": "BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG",
    "autorenew": true,
    "serviceProvider": "Amazon Prime",
    "baseCurrencyCode": "EUR"
  }
]

Digital subscriptions billing schedules

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
startPeriod The period that specifies when the default digital subscription item will be overridden with another. 2
endPeriod The period when the digital subscription item will expire. 2
price The price of the digital subscription item. 3.99
baseCurrencyCode The currency code for the price, formatted according to ISO 4217 standard. EUR
subscriptionId The unique identifier for the digital subscription. BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Subscriptions - Billing Schedules",
  "description": "Includes the list of digital subscriptions schedule, like start period, end period, price and currency.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "startPeriod": {
        "type": "string",
        "description": "The period that specifies when the default digital subscription item will be overridden with another (e.g., 2)."
      },
      "endPeriod": {
        "type": "string",
        "description": "The period when the digital subscription item will expire (e.g., 2)."
      },
      "price": {
        "description": "The price of the digital subscription item (e.g., 3.99).",
        "type": "number"
      },
      "baseCurrencyCode": {
        "type": "string",
        "description": "The currency code for the price, formatted according to ISO 4217 standard (e.g., EUR)."
      },
      "subscriptionId": {
        "type": "string",
        "description": "The unique identifier for the digital subscription (e.g., BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG)."
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "baseCurrencyCode",
      "subscriptionId"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "startPeriod": "2",
    "endPeriod": "2",
    "price": 3.99,
    "baseCurrencyCode": "EUR",
    "subscriptionId": "BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG"
  }
]

Digital subscriptions status history

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
subscriptionId The unique identifier for the digital subscription. BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG
subscriptionStatusStartDate The date when the subscription transitioned to current status, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ssZ). 2018-01-20T12:57:00Z
subscriptionStatusEndDate The date when the subscription transitioned out of current status, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ssZ). 2019-02-05T12:57:00Z
statusTransitionReason The reason why the subscription went into this status. Subscription Pending Activation
subscriptionStatus The state of the subscription. Pending

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Digital Subscriptions - Status History",
  "description": "Includes the history of the digital subscriptions status and insights like their status transition reason and their start and end dates.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "subscriptionId": {
        "type": "string",
        "description": "The unique identifier for the subscription (e.g., BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG)."
      },
      "subscriptionStatusStartDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the subscription transitioned to current status, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ssZ - 2018-01-20T12:57:00Z)."
      },
      "subscriptionStatusEndDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the subscription transitioned out of current status, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ssZ - 2019-02-05T12:57:00Z)."
      },
      "statusTransitionReason": {
        "description": "The reason why the subscription went into this status (e.g., Subscription Pending Activation).",
        "type": "string",
        "enum": [
          "Subscription Cancelled",
          "Subscription Paused",
          "Subscription Activated",
          "Subscription Pending Activation"
        ]
      },
      "subscriptionStatus": {
        "description": "The state of the subscription (e.g., Pending).",
        "type": "string",
        "enum": [
          "Active",
          "Pending",
          "CancelPending",
          "Cancelled",
          "CreationPending",
          "Paused",
          "Suspended"
        ]
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "subscriptionId",
      "statusTransitionReason",
      "subscriptionStatus"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "subscriptionId": "BGI4EJVQBPLEP8U7BC721M3FFVLM8PN4TT42J0AFE5NB1L4L5FBG",
    "subscriptionStatusStartDate": "2018-01-20T12:57:00Z",
    "subscriptionStatusEndDate": "2019-02-05T12:57:00Z",
    "statusTransitionReason": "Subscription Pending Activation",
    "subscriptionStatus": "Pending"
  }
]

Garage vehicles

This scope includes Amazon customer's list of vehicles from their virtual garage, with details like make, model, type, and mileage.

Identifiers:

  • Login with Amazon Scope Name: portability::garage_vehicles
  • Amazon Data Portability scopeId : portability-garage-vehicles

Garage vehicles

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
make The brand name of the vehicle. Hyundai
model The model name of the vehicle. I10
vehicleType The vehicle type used to recognize type of variant of vehicle created by the brand. CAR
engineType The vehicle engine type. 1.2 (64 kW / 87 HP)
vehicleId The ID/rank of the vehicle in customer's garage. 2
variant The variant of the vehicle created by the brand. II Hatchback - 08/13
mileage The mileage of the car. 500
mileageUnit The unit used for measuring mileage of the car. MILES
mileageRate The average mileage of the car in a given time frame. 500
mileageRateUnit The unit for measuring mileage rate. MILES_PER_YEAR

Sample schema:

{
  "$schema": "http://json-schema.org/draft/2020-12/schema#",
  "title": "Garage Vehicles",
  "description": "Includes the list of vehicles from customer's virtual garage, with details like make, model, type or mileage.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "make": {
        "type": "string",
        "description": "The brand name of the vehicle (e.g., Hyundai)."
      },
      "model": {
        "type": "string",
        "description": "The model name of the vehicle (e.g., I10)."
      },
      "vehicleType": {
        "type": "string",
        "enum": [
          "CAR",
          "MOTORCYCLE"
        ],
        "description": "The vehicle type used to recognize type of variant of vehicle created by the brand (e.g., CAR)."
      },
      "engineType": {
        "type": "string",
        "description": "The vehicle engine type (e.g., 1.2 (64 kW / 87 HP)."
      },
      "vehicleId": {
        "type": "integer",
        "description": "The ID/rank of the vehicle in customer's garage (e.g., 2)."
      },
      "variant": {
        "type": "string",
        "description": "The variant of the vehicle created by the brand (e.g., II Hatchback - 08/13)."
      },
      "mileage": {
        "type": "integer",
        "description": "The mileage of the car (e.g., 12)."
      },
      "mileageUnit": {
        "type": "string",
        "enum": [
          "KILOMETERS",
          "MILES"
        ],
        "description": "The unit used for measuring mileage of the car (e.g., MILES)."
      },
      "mileageRate": {
        "type": "integer",
        "description": "The average mileage of the car in a given time frame (e.g., 500)."
      },
      "mileageRateUnit": {
        "type": "string",
        "enum": [
          "KILOMETERS_PER_YEAR",
          "MILES_PER_YEAR"
        ],
        "description": "The unit for measuring mileage rate (e.g., MILES_PER_YEAR)."
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "make",
      "model",
      "vehicleType",
      "engineType",
      "variant",
      "vehicleId"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "make": "Hyundai",
    "model": "I10",
    "vehicleType": "CAR",
    "engineType": "1.2 (64 kW / 87 HP)",
    "vehicleId": 2,
    "variant": "II Hatchback - 08/13",
    "mileage": 12,
    "mileageUnit": "MILES",
    "mileageRate": 500,
    "mileageRateUnit": "MILES_PER_YEAR"
  }
]

Gift lists

This scope includes Amazon customer's created gift lists with details such as their name, creation date, products in the lists, and gift registry.

Identifiers:

  • Login with Amazon Scope Name: portability::gifts
  • Amazon Data Portability scopeId : portability-gifts

Gift lists

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
registryType The type of the gift list. WEDDING
isActive The flag that indicates whether the gift list is active. true
listEventDate The date of gift list event. 2017-05-09
eventCity The city location of the event. Wernigerode
eventState The state location of the event. Sachsen-Anhalt
eventCountry The country location of the event. Germany
isSharedWithPartnerSite The flag that indicates whether the option to share the gift list with a partner is enabled. false
privacy The state that indicates the visibility of the gift list. PUBLIC
registryPurchases The registry of the purchases. N/A
registryPurchases.giftCardBalancePurchaseAmount The amount of a gift card that was used on the purchase amount. 0.0
registryPurchases.purchaseDate The date of the gift list purchase, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2017-10-14T10:33:34.106Z
registryPurchases.isCancelled The flag that indicates whether the order was cancelled. false
registryPurchases.purchaseAmount The cost of the purchase. 64.99
registryPurchases.purchaseQuantity The quantity of the purchase. 1
registryPurchases.product The purchased product details. N/A
registryPurchases.product.productName The purchased product name. TV Wall Mount, JUSTSTONE TV Bracket Fits Most 26-65 Inch LED Flat & Curved TVs
registryPurchases.product.asin The identifier of the purchased product, a unique ten-digit alphanumeric code. B07YWSY5TG
vanityUrls The list of vanity URLs. N/A
vanityUrls.isActive The flag that specifies whether the gift list is active or not. false
vanityUrls.url The vanity url. https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4
vanityUrls.originalUrl The original vanity url. https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Gift Lists",
  "description": "Includes the list of gifts the customer created with details such as the list name, date created, products in the lists and their purchase registry.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "pattern": "^[A-Z]{2}$",
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "registryType": {
        "enum": [
          "WEDDING",
          "BABY",
          "CUSTOM",
          "BIRTHDAY",
          "PET",
          "HOLIDAY"
        ],
        "description": "The type of the gift list (e.g., WEDDING)."
      },
      "isActive": {
        "type": "boolean",
        "description": "The flag that indicates whether the gift list is active (e.g., true)."
      },
      "listEventDate": {
        "type": "string",
        "format": "full-date",
        "description": "The date of gift list event (e.g., 2017-05-09)."
      },
      "eventCity": {
        "type": "string",
        "description": "The city location of the event (e.g., Wernigerode)."
      },
      "eventState": {
        "type": "string",
        "description": "The state location of the event (e.g., Sachsen-Anhalt)."
      },
      "eventCountry": {
        "type": "string",
        "description": "The country location of the event (e.g., Germany)."
      },
      "isSharedWithPartnerSite": {
        "type": "boolean",
        "description": "The flag that indicates whether the option to share the gift list with a partner is enabled (e.g., false)."
      },
      "privacy": {
        "enum": [
          "PUBLIC",
          "PRIVATE",
          "SHARED"
        ],
        "description": "The state that indicates the visibility of the gift list (e.g., PUBLIC)."
      },
      "registryPurchases": {
        "type": "array",
        "description": "The registry of the purchases.",
        "items": {
          "type": "object",
          "properties": {
            "giftCardBalancePurchaseAmount": {
              "type": "number",
              "description": "The amount of a gift card that was used on the purchase amount (e.g., 0.0)."
            },
            "purchaseDate": {
              "type": "string",
              "format": "date-time",
              "description": "The date of the gift list purchase, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2017-10-14T10:33:34.106Z)."
            },
            "isCancelled": {
              "type": "boolean",
              "description": "The flag that indicates whether the order was cancelled (e.g., false)."
            },
            "purchaseAmount": {
              "type": "number",
              "description": "The cost of the purchase (e.g., 64.99)."
            },
            "purchaseQuantity": {
              "type": "number",
              "description": "The quantity of the purchase (e.g., 1)."
            },
            "product": {
              "type": "object",
              "description": "The purchased product details.",
              "properties": {
                "productName": {
                  "type": "string",
                  "description": "The purchased product name (e.g., TV Wall Mount, JUSTSTONE TV Bracket Fits Most 26-65 Inch LED Flat & Curved TVs)."
                },
                "asin": {
                  "type": "string",
                  "description": "The identifier of the purchased product, a unique ten-digit alphanumeric code (e.g., B07YWSY5TG)."
                }
              },
              "required": [
                "asin"
              ]
            }
          },
          "required": [
            "giftCardBalancePurchaseAmount",
            "purchaseDate",
            "isCancelled",
            "purchaseAmount",
            "purchaseQuantity",
            "product"
          ]
        }
      },
      "vanityUrls": {
        "type": "array",
        "description": "The list of vanity URLs.",
        "items": {
          "type": "object",
          "properties": {
            "isActive": {
              "type": "boolean",
              "description": "The flag that specifies whether the gift list is active or not (e.g., false)."
            },
            "url": {
              "type": "string",
              "description": "The vanity url (e.g., https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4)."
            },
            "originalUrl": {
              "type": "string",
              "description": "The original vanity url (e.g., https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4)."
            }
          },
          "required": [
            "isActive",
            "url",
            "originalUrl"
          ]
        }
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "registryType",
      "isActive"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "registryType": "WEDDING",
    "isActive": true,
    "listEventDate": "2017-05-09",
    "eventCity": "Wernigerode",
    "eventState": "Sachsen-Anhalt",
    "eventCountry": "Germany",
    "isSharedWithPartnerSite": false,
    "privacy": "PUBLIC",
    "registryPurchases": [
      {
        "giftCardBalancePurchaseAmount": 0.0,
        "purchaseDate": "2017-10-14T10:33:34.106Z",
        "isCancelled": false,
        "purchaseAmount": 64.99,
        "purchaseQuantity": 1,
        "product": {
          "productName": "TV Wall Mount, JUSTSTONE TV Bracket Fits Most 26-65 Inch LED Flat & Curved TVs",
          "asin": "B07YWSY5TG"
        }
      }
    ],
    "vanityUrls": [
      {
        "isActive": false,
        "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4",
        "originalUrl": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/a34ef979-678d-417a-b804-227568ea2ad9/default.jobtemplate.mp4.480.mp4"
      }
    ]
  }
]

Lists

This scope includes Amazon customer's occasion lists with details like name, occasion, and description.

Identifiers:

  • Login with Amazon Scope Name: portability::lists
  • Amazon Data Portability scopeId : portability-lists

Lists

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
listAccessPolicy The access policy for the list. PUBLIC
archived The flag that indicates that the list is archived. false
babyRegistryFlags The baby registry flags. N/A
babyRegistryFlags.receiveRegistryTips The flag that indicates that the customer has opted to receive registry tips. false
babyRegistryFlags.marketingEmailsEnabled The flag that indicates that the customer has opted to receive marketing emails. false
babyRegistryFlags.claimCodeSent The flag that indicates that the claim code has been sent to the co-registrant. false
babyRegistryFlags.registerForDiaperFund The flag that indicates that the customer has registered their list for the diaper fund. false
babyRegistryFlags.giftCardOptIn The flag that indicates that the customer has opted in for showing gift cards on their list. false
babyRegistryFlags.shareWithPartnerSites The flag that indicates that the customer has opted to share their data with partner sites. false
babyRegistryFlags.listEmailsEnabled The flag that indicates that the customer has opted to receive list emails. false
babyRegistryFlags.primeOptIn The flag that indicates that the customer has opted in for showing Prime membership on their list. true
babyRegistryFlags.isFirstBaby The flag that indicates that this is the first baby. false
checklistUseCase The use case for which the list is created. sport:baseball
deleted The flag that indicates that the relation between the user and the list has been deleted. false
listDescription The description associated with the list. Birthday Party
eventSearchTag The tag used for filtering event registry search results. events
listSettings The set of flags based of actions the user has taken to record where users have opted-in or opted-out. KEEP_GIFT_SURPRISE_ENABLED
recipientGender The gender of the user. FEMALE
giftFund The gift fund. N/A
giftFund.goalAmount The goal amount of the gift fund. N/A
giftFund.goalAmount.amount The monetary amount. N/A
giftFund.goalAmount.amount.value The monetary amount value. 1
giftFund.goalAmount.amount.currencyCode The currency code of the monetary amount value formatted according to ISO 4217 standard. EUR
giftFund.goalAmount.isHidden The flag that indicates whether the amount is hidden. false
giftFund.giftFundDescription The description of the gift fund. My first gift fund
giftFund.giftFundImageUrl The url to the image of the gift fund. https://images-fe.ssl-images-amazon.com/images/S/amazon-cover-photo/default._SX110_.png
giftFund.giftFundTitle The title of the gift fund. Happy Birthday to Me
interests The list of user's interests. Reading
listName The name associated with the list. Birthday
calendarDefinedOccasion The occasion associated with the list. N/A
calendarDefinedOccasion.name The name of the occasion. CHRISTMAS
calendarDefinedOccasion.startYear The year the occasion is created in. 2022
calendarDefinedOccasion.eventLocation The event location where the occasion occurs. N/A
calendarDefinedOccasion.eventLocation.country The country that the event is held in. France
calendarDefinedOccasion.eventLocation.city The city that the event is held in. Paris
calendarDefinedOccasion.eventLocation.state The state that the event is held in. Paris
calendarDefinedOccasion.reminderPreferences The preferences for when reminder emails should be sent for the occasion. N/A
calendarDefinedOccasion.reminderPreferences.timeBefore The amount of time before the occasion date to send reminder emails. 2
calendarDefinedOccasion.reminderPreferences.timeUnit The unit of time used for the amount of time before the occasion date to send reminder emails. days
recurrencePreferences The recurrence preferences. N/A
recurrencePreferences.recurrenceInterval The recurrence interval. 3
recurrencePreferences.timeUnit The time unit for the recurrence interval. days
customNamedOccasion The custom named occasion. N/A
customNamedOccasion.name The name of the custom named occasion. My Birthday
customNamedOccasion.description The description of the custom named occasion. Gifts for my birthday
customNamedOccasion.month The month of the custom named occasion. MAY
customNamedOccasion.day The day of the custom named occasion. 14
customNamedOccasion.startYear The year of the custom named occasion. 2025
customNamedOccasion.ageStartYear The age at when the custom named occasion occurs. 7
customNamedOccasion.eventLocation The event location used to describe the location of the custom named occasion. N/A
customNamedOccasion.eventLocation.country The country of the location for the custom named occasion. France
customNamedOccasion.eventLocation.city The city of the location for the custom named occasion. Paris
customNamedOccasion.eventLocation.state The state of the location for the custom named occasion. Paris
customNamedOccasion.reminderPreferences The recurrence preferences for the custom named occasion. N/A
customNamedOccasion.reminderPreferences.timeBefore The amount of time before the custom named occasion to start the reminder. 10
customNamedOccasion.reminderPreferences.timeUnit The unit of time for the amount of time before the custom named occasion to start the reminder. days
customNamedOccasion.recurrencePreferences The recurrence preferences for the named occasion. N/A
customNamedOccasion.recurrencePreferences -> recurrenceInterval The recurrence interval for the custom named occasion. 3
customNamedOccasion.recurrencePreferences.timeUnit The unit of time for the recurrence interval of the custom named occasion. days
namedOccasion The named occasion. N/A
namedOccasion.name The name of the named occasion. BIRTHDAY
namedOccasion.description The description of the named occasion. Gifts for my birthday
namedOccasion.month The month of the named occasion. MAY
namedOccasion.day The day of the named occasion. 14
namedOccasion.startYear The year of the named occasion. 2022
namedOccasion.ageAtStartYear The age at when the named occasion occurs. 7
namedOccasion.eventLocation The event location used to describe the location of the named occasion. N/A
namedOccasion.eventLocation.country The country of the location for the named occasion. France
namedOccasion.eventLocation.city The city of the location for the named occasion. Paris
namedOccasion.eventLocation.state The state of the location for the named occasion. Paris
namedOccasion.reminderPreferences The reminder preferences for the named occasion. N/A
namedOccasion.reminderPreferences.timeBefore The amount of time before the named occasion to start the reminder. 10
namedOccasion.reminderPreferences.timeUnit The unit of time for the amount of time before the named occasion to start the reminder. days
namedOccasion.recurrencePreferences The recurrence preferences for the named occasion. N/A
namedOccasion.recurrencePreferences.recurrenceInterval The recurrence interval for the named occasion. 3
namedOccasion.recurrencePreferences.timeUnit The unit of time for the recurrence interval of the named occasion. days
organizationUrl The URL of the organization website. www.maxwells-organization.org
recipientAge The age range for the recipient. N/A
recipientAge.startAge The start of the age range. 4
recipientAge.endAge The end of the age range. 5
ownerRelationship The information about the relationship between a user and the owner of a list. Partner
searchTerm The search keywords. N/A
searchTerm.keyword The keyword that customers want to store on their list in order to find related products. cat
searchTerm.checkedOff The flag that indicates that at least one product has been added to the list based of the keyword. false
userRole The name of the role of a user in a list. GROOM

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Lists",
  "description": "Includes all occasion lists defined by the customer with details such as name, occasion and description.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "listAccessPolicy": {
        "type": "string",
        "description": "The access policy for the list (e.g., PUBLIC)."
      },
      "archived": {
        "type": "boolean",
        "description": "The flag that indicates that the list is archived (e.g., false)."
      },
      "babyRegistryFlags": {
        "type": "object",
        "description": "The baby registry flags.",
        "properties": {
          "receiveRegistryTips": {
            "type": "boolean",
            "description": "The flag that indicates that the customer has opted to receive registry tips (e.g., false)."
          },
          "marketingEmailsEnabled": {
            "type": "boolean",
            "description": "The flag that indicates that the customer has opted to receive marketing emails (e.g., false)."
          },
          "claimCodeSent": {
            "type": "boolean",
            "description": "The flag that indicates that the claim code has been sent to the co-registrant (e.g., false)."
          },
          "registerForDiaperFund": {
            "type": "boolean",
            "description": "The flag that indicates that the customer has registered their list for the diaper fund (e.g., false)."
          },
          "giftCardOptIn": {
            "type": "boolean",
            "description": "The flag that indicates that the customer has opted in for showing gift cards on their list (e.g., false)."
          },
          "shareWithPartnerSites": {
            "type": "boolean",
            "description": "The flag that indicates that the customer has opted to share their data with partner sites (e.g., false)."
          },
          "listEmailsEnabled": {
            "type": "boolean",
            "description": "The flag that indicates that the customer has opted to receive list emails (e.g., false)."
          },
          "primeOptIn": {
            "type": "boolean",
            "description": "The flag that indicates that the customer has opted in for showing Prime membership on their list (e.g., true)."
          },
          "isFirstBaby": {
            "type": "boolean",
            "description": "The flag that indicates that this is the first baby (e.g., false)."
          }
        }
      },
      "checklistUseCase": {
        "type": "string",
        "description": "The use case for which the list is created (e.g., sport:baseball)."
      },
      "deleted": {
        "type": "boolean",
        "description": "The flag that indicates that the relation between the user and the list has been deleted (e.g., false)."
      },
      "listDescription": {
        "type": "string",
        "description": "The description associated with the list (e.g., Birthday Party)."
      },
      "eventSearchTag": {
        "type": "string",
        "description": "The tag used for filtering event registry search results (e.g., events)."
      },
      "listSettings": {
        "type": "array",
        "description": "The set of flags based of actions the user has taken to record where users have opted-in or opted-out (e.g., KEEP_GIFT_SURPRISE_ENABLED).",
        "items": {
          "type": "string",
          "enum": [
            "WISH_LIST_DISMISSED",
            "SHOPPING_LIST_DISMISSED",
            "AUTO_REMEMBER_DISABLED",
            "AUTO_REMEMBER_EMAIL_DISABLED",
            "AUTO_REMEMBER_EMAIL_SENT",
            "CLAIM_CODE_SENT",
            "MARKETING_EMAILS_ENABLED",
            "LIST_EMAILS_ENABLED",
            "VENDOR_EMAILS_ENABLED",
            "SHARE_WITH_PARTNER_SITE_ENABLED",
            "PLEASE_NO_GIFT_WRAP",
            "BLACKOUT_FILTER_DISABLED",
            "SCHOOL_LIST_POPOVER_DISPLAYED",
            "REFERRED_REGISTRY_ENABLED",
            "KEEP_GIFT_SURPRISE_ENABLED"
          ]
        }
      },
      "recipientGender": {
        "type": "string",
        "description": "The gender of the user (e.g., FEMALE).",
        "enum": [
          "MALE",
          "FEMALE",
          "UNKNOWN"
        ]
      },
      "giftFund": {
        "type": "object",
        "description": "The gift fund.",
        "properties": {
          "goalAmount": {
            "type": "object",
            "description": "The goal amount of the gift fund.",
            "properties": {
              "amount": {
                "type": "object",
                "description": "The monetary amount.",
                "properties": {
                  "value": {
                    "type": "integer",
                    "description": "The monetary amount value (e.g., 1).",
                    "minimum": 0
                  },
                  "currencyUnit": {
                    "type": "string",
                    "description": "The currency code of the monetary amount value formatted according to ISO 4217 standard (e.g., EUR)."
                  }
                },
                "required": [
                  "value",
                  "currencyUnit"
                ]
              },
              "isHidden": {
                "type": "boolean",
                "description": "The flag that indicates whether the amount is hidden (e.g., false)."
              }
            }
          },
          "giftFundDescription": {
            "type": "string",
            "description": "The description of the gift fund (e.g., My first gift fund)."
          },
          "giftFundImageUrl": {
            "type": "string",
            "description": "The url to the image of the gift fund (e.g., https://images-fe.ssl-images-amazon.com/images/S/amazon-cover-photo/default._SX110_.png)."
          },
          "giftFundTitle": {
            "type": "string",
            "description": "The title of the gift fund (e.g., Happy Birthday to Me)."
          }
        }
      },
      "interests": {
        "type": "array",
        "description": "The list of user's interests (e.g., Reading).",
        "items": {
          "type": "string"
        }
      },
      "listName": {
        "type": "string",
        "description": "The name associated with the list (e.g., Birthday)."
      },
      "calendarDefinedOccasion": {
        "type": "object",
        "description": "The occasion associated with the list.",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the occasion (e.g., CHRISTMAS).",
            "enum": [
              "ADMIN_PROFESSIONAL_DAY",
              "BOSS_DAY",
              "CHRISTMAS",
              "EASTER",
              "FATHERS_DAY",
              "GRANDPARENTS_DAY",
              "HALLOWEEN",
              "HANUKKAH",
              "INDEPENDENCE_DAY",
              "KWANZAA",
              "LABOR_DAY",
              "MOTHERS_DAY",
              "NEW_YEARS_DAY",
              "PASSOVER",
              "THANKSGIVING",
              "VALENTINES_DAY"
            ]
          },
          "startYear": {
            "type": "integer",
            "description": "The year the occasion is created in (e.g., 2022)."
          },
          "eventLocation": {
            "type": "object",
            "description": "The event location where the occasion occurs.",
            "properties": {
              "country": {
                "type": "string",
                "description": "The country that the event is held in (e.g., France)."
              },
              "city": {
                "type": "string",
                "description": "The city that the event is held in (e.g., Paris)."
              },
              "state": {
                "type": "string",
                "description": "The state that the event is held in (e.g., Paris)."
              }
            }
          },
          "reminderPreferences": {
            "type": "object",
            "description": "The preferences for when reminder emails should be sent for the occasion.",
            "properties": {
              "timeBefore": {
                "type": "integer",
                "description": "The amount of time before the occasion date to send reminder emails (e.g., 2)."
              },
              "timeUnit": {
                "type": "string",
                "description": "The unit of time used for the amount of time before the occasion date to send reminder emails (e.g., days)."
              }
            },
            "required": [
              "timeBefore",
              "timeUnit"
            ]
          },
          "recurrencePreferences": {
            "type": "object",
            "description": "The recurrence preferences.",
            "properties": {
              "recurrenceInterval": {
                "type": "integer",
                "description": "The recurrence interval (e.g., 3)."
              },
              "timeUnit": {
                "type": "string",
                "description": "The time unit for the recurrence interval (e.g., days)."
              }
            },
            "required": [
              "recurrenceInterval",
              "timeUnit"
            ]
          }
        },
        "required": [
          "name"
        ]
      },
      "customNamedOccasion": {
        "type": "object",
        "description": "The custom named occasion.",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the custom named occasion (e.g., My Birthday)."
          },
          "description": {
            "type": "string",
            "description": "The description of the custom named occasion (e.g., Gift for my birthday)."
          },
          "month": {
            "type": "string",
            "description": "The month of the custom named occasion (e.g., MAY)."
          },
          "day": {
            "type": "integer",
            "description": "The day of the custom named occasion (e.g., 14)."
          },
          "startYear": {
            "type": "integer",
            "description": "The year of the custom named occasion (e.g., 2022)."
          },
          "ageAtStartYear": {
            "type": "integer",
            "description": "The age at when the custom  named occasion occurs (e.g., 7)."
          },
          "eventLocation": {
            "type": "object",
            "description": "The event location used to describe the location of the custom named occasion.",
            "properties": {
              "country": {
                "type": "string",
                "description": "The country of the location for the custom named occasion (e.g., France)."
              },
              "city": {
                "type": "string",
                "description": "The city of the location for the custom named occasion (e.g., Paris)."
              },
              "state": {
                "type": "string",
                "description": "The state of the location for the custom named occasion (e.g., Paris)."
              }
            }
          },
          "reminderPreferences": {
            "type": "object",
            "description": "The recurrence preferences for the custom named occasion.",
            "properties": {
              "timeBefore": {
                "type": "integer",
                "description": "The amount of time before the custom named occasion to start the reminder (e.g., 10)."
              },
              "timeUnit": {
                "type": "string",
                "description": "The unit of time for the amount of time before the custom  named occasion to start the reminder (e.g., days)."
              }
            },
            "required": [
              "timeBefore",
              "timeUnit"
            ]
          },
          "recurrencePreferences": {
            "type": "object",
            "description": "The recurrence preferences for the named occasion.",
            "properties": {
              "recurrenceInterval": {
                "type": "integer",
                "description": "The recurrence interval for the custom named occasion (e.g., 3)."
              },
              "timeUnit": {
                "type": "string",
                "description": "The unit of time for the recurrence interval of the custom named occasion (e.g., days)."
              }
            },
            "required": [
              "recurrenceInterval",
              "timeUnit"
            ]
          }
        },
        "required": [
          "name"
        ]
      },
      "namedOccasion": {
        "type": "object",
        "description": "The named occasion.",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the named occasion (e.g., BIRTHDAY).",
            "enum": [
              "ANNIVERSARY",
              "BABY_SHOWER",
              "BIRTHDAY",
              "WISHLIST_BIRTHDAY",
              "BRIDAL_SHOWER",
              "CONGRATULATIONS",
              "GRADUATION",
              "HOUSE_WARMING",
              "MAZEL_TOV",
              "WEDDING",
              "CUSTOM",
              "HOLIDAY",
              "PET"
            ]
          },
          "description": {
            "type": "string",
            "description": "The description of the named occasion (e.g., Gifts for my birthday)."
          },
          "month": {
            "type": "string",
            "description": "The month of the named occasion (e.g., MAY)."
          },
          "day": {
            "type": "integer",
            "description": "The day of the named occasion (e.g., 14)."
          },
          "startYear": {
            "type": "integer",
            "description": "The year of the named occasion (e.g., 2022)."
          },
          "ageAtStartYear": {
            "type": "integer",
            "description": "The age at when the named occasion occurs (e.g., 7)."
          },
          "eventLocation": {
            "type": "object",
            "description": "The event location used to describe the location of the named occasion.",
            "properties": {
              "country": {
                "type": "string",
                "description": "The country of the location for the named occasion (e.g., France)."
              },
              "city": {
                "type": "string",
                "description": "The city of the location for the named occasion (e.g., Paris)."
              },
              "state": {
                "type": "string",
                "description": "The state of the location for the named occasion (e.g., Paris)."
              }
            }
          },
          "reminderPreferences": {
            "type": "object",
            "description": "The reminder preferences for the named occasion.",
            "properties": {
              "timeBefore": {
                "type": "integer",
                "description": "The amount of time before the named occasion to start the reminder (e.g., 10)."
              },
              "timeUnit": {
                "type": "string",
                "description": "The unit of time for the amount of time before the named occasion to start the reminder (e.g., days)."
              }
            },
            "required": [
              "timeBefore",
              "timeUnit"
            ]
          },
          "recurrencePreferences": {
            "type": "object",
            "description": "The recurrence preferences for the named occasion.",
            "properties": {
              "recurrenceInterval": {
                "type": "integer",
                "description": "The recurrence interval for the named occasion (e.g., 3)."
              },
              "timeUnit": {
                "type": "string",
                "description": "The unit of time for the recurrence interval of the named occasion (e.g., days)."
              }
            },
            "required": [
              "recurrenceInterval",
              "timeUnit"
            ]
          }
        },
        "required": [
          "name"
        ]
      },
      "organizationUrl": {
        "type": "string",
        "description": "The URL of the organization website (e.g., www.maxwells-organization.org)."
      },
      "recipientAge": {
        "type": "object",
        "description": "The age range for the recipient.",
        "properties": {
          "startAge": {
            "type": "integer",
            "description": "The start of the age range (e.g., 4)."
          },
          "endAge": {
            "type": "integer",
            "description": "The end of the age range (e.g., 5)."
          }
        },
        "required": [
          "startAge",
          "endAge"
        ]
      },
      "ownerRelationship": {
        "type": "string",
        "description": "The information about the relationship between a user and the owner of a list (e.g., Partner)."
      },
      "searchTerm": {
        "type": "object",
        "description": "The search keywords.",
        "properties": {
          "keyword": {
            "type": "string",
            "pattern": "\\s*\\S+.*",
            "description": "The keyword that customers want to store on their list in order to find related products (e.g., cat)."
          },
          "checkedOff": {
            "type": "boolean",
            "description": "The flag that indicates that at least one product has been added to the list based of the keyword (e.g., false)."
          }
        },
        "required": [
          "keyword",
          "checkedOff"
        ],
        "unevaluatedProperties": false
      },
      "userRole": {
        "type": "string",
        "description": "The name of the role of a user in a list (e.g., GROOM)."
      },
      "marketplace": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      }
    },
    "required": [
      "marketplace",
      "eventDate"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "listAccessPolicy": "PUBLIC",
    "archived": false,
    "babyRegistryFlags": {
      "receiveRegistryTips": false,
      "marketingEmailsEnabled": false,
      "claimCodeSent": false,
      "registerForDiaperFund": false,
      "giftCardOptIn": false,
      "shareWithPartnerSites": false,
      "listEmailsEnabled": false,
      "primeOptIn": true,
      "isFirstBaby": false
    },
    "checklistUseCase": "sport:baseball",
    "deleted": false,
    "listDescription": "Birthday Party",
    "eventSearchTag": "events",
    "listSettings": [
      "KEEP_GIFT_SURPRISE_ENABLED"
    ],
    "recipientGender": "FEMALE",
    "giftFund": {
      "goalAmount": {
        "value": 1,
        "currencyUnit": "EUR"
      },
      "isHidden": false,
      "giftFundDescription": "My first gift fund",
      "giftFundImageUrl": "https://images-fe.ssl-images-amazon.com/images/S/amazon-cover-photo/default._SX110_.png",
      "giftFundTitle": "Happy Birthday to Me"
    },
    "interests": [
      "Reading"
    ],
    "listName": "Birthday",
    "calendarDefinedOccasion": {
      "name": "CHRISTMAS",
      "startYear": 2022,
      "eventLocation": {
        "country": "France",
        "city": "Paris",
        "state": "Paris"
      },
      "reminderPreferences": {
        "type": "object",
        "timeBefore": 2,
        "timeUnit": "days"
      },
      "recurrencePreferences": {
        "recurrenceInterval": 3,
        "timeUnit": "days"
      }
    },
    "customNamedOccasion": {
      "name": "My Birthday",
      "description": "Gift for my birthday",
      "month": "MAY",
      "day": 14,
      "startYear": 2022,
      "ageAtStartYear": 7,
      "eventLocation": {
        "country": "France",
        "city": "Paris",
        "state": "Paris"
      },
      "reminderPreferences": {
        "timeBefore": 10,
        "timeUnit": "days"
      },
      "recurrencePreferences": {
        "recurrenceInterval": 3,
        "timeUnit": "days"
      }
    },
    "namedOccasion": {
      "name": "BIRTHDAY",
      "description": "Gifts for my birthday",
      "month": "MAY",
      "day": 14,
      "startYear": 2022,
      "ageAtStartYear": 7,
      "eventLocation": {
        "country": "France",
        "city": "Paris",
        "state": "Paris"
      },
      "reminderPreferences": {
        "timeBefore": 10,
        "timeUnit": "days"
      },
      "recurrencePreferences": {
        "recurrenceInterval": 3,
        "timeUnit": "days"
      }
    },
    "organizationUrl": "www.maxwells-organization.org",
    "recipientAge": {
      "startAge": 4,
      "endAge": 5
    },
    "ownerRelationship": "Partner",
    "searchTerm": {
      "keyword": "cat",
      "checkedOff": false
    },
    "userRole": "GROOM"
  }
]

Physical order returns

This scope includes Amazon customer's physical order returns history with details like product refund amounts and their dates.

Identifiers:

  • Login with Amazon Scope Name: portability::physical_order_returns
  • Amazon Data Portability scopeId : portability-physical-order-returns

Physical order return payments

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
orderId The unique identifier for the order which the return/reversal corresponds. 403-9139873-1268352
amountRefunded The amount of money refunded to the customer (23.45). 23.45

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Physical Orders - Return Payments",
  "description": "Includes the list of payments for the customer's physical order returns.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "pattern": "^[A-Z]{2}$"
      },
      "orderId": {
        "type": "string",
        "description": "The unique identifier for the order which the return/reversal corresponds."
      },
      "amountRefunded": {
        "type": "string",
        "description": "The amount of money refunded to the customer (23.45)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "marketplace",
      "eventDate"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "orderId": "403-9139873-1268352",
    "amountRefunded": "23.45"
  }
]

Physical order returns

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
creationDate The date when the return was initiated, in the ISO 8601 date-time format and UTC time zone. 2023-11-28T11:55:29.540Z
orderId The unique identifier for the order which the return corresponds. 403-9139873-1268352
currencyCode The currency code for the pricing data, formatted according to ISO 4217 standard. EUR
quantity The number of units being returned of the product. 1
reversalReason The reason chosen by the to initiate the return process. customer return

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Physical Orders - Returns",
  "description": "Includes the list of customer's physical order returns.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "creationDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the return was initiated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "pattern": "^[A-Z]{2}$"
      },
      "orderId": {
        "type": "string",
        "description": "The unique identifier for the order which the return corresponds (e.g., 403-9139873-1268352)."
      },
      "currencyCode": {
        "type": "string",
        "description": "The currency code for the pricing data, formatted according to ISO 4217 standard (e.g., EUR)."
      },
      "quantity": {
        "type": "integer",
        "description": "The number of units being returned of the product (1)."
      },
      "reversalReason": {
        "type": "string",
        "description": "The reason chosen by the to initiate the return process (e.g., customer return)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "marketplace",
      "eventDate",
      "creationDate"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "creationDate": "2021-09-29T11:04:43.305Z",
    "orderId": "403-9139873-1268352",
    "currencyCode": "EUR",
    "quantity": 1,
    "reversalReason": "customer return"
  }
]

Physical orders

This scope includes Amazon customer's physical order history with details like product names, quantity, and prices paid.

Identifiers:

  • Login with Amazon Scope Name: portability::physical_orders
  • Amazon Data Portability scopeId: portability-physical-orders

Physical orders

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
productName The title of the product as displayed on the Amazon Retail Website product page. Amazon Fire HD 10 tablet, 1080p Full HD, 32 GB, latest model (2021 release), Lavender
website The domain of the Amazon Retail Website where the order was placed. Amazon.fr, Amazon.it, Amazon.de
orderId The unique identifier for an order which the product belongs to. 701-7195934-7003458
orderDate The date when the customer placed the order, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2023-04-11T08:26:22Z
currencyCode The currency code for the price, formatted according to ISO 4217 standard. EUR
quantity The quantity of the product. 1
productCondition The condition of the product, whether it is used or new. New, Used
totalOwed The total price of the order including all charges and discounts. 21.39

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Physical Orders",
  "description": "Includes account's physical orders history, like product names, quantity and prices paid.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "orderDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the customer placed the order, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "pattern": "^[A-Z]{2}$"
      },
      "productName": {
        "type": "string",
        "description": "The title of the product as displayed on the Amazon Retail Website product page (e.g., Amazon Fire HD 10 tablet, 1080p Full HD, 32 GB, Lavender)."
      },
      "website": {
        "type": "string",
        "description": "The domain of the Amazon Retail Website where the order was placed (e.g., Amazon.fr, Amazon.de, Amazon.com.be, etc.)."
      },
      "orderId": {
        "type": "string",
        "description": "The unique identifier for an order which the product belongs to (e.g., 701-7195934-7003458)."
      },
      "currencyCode": {
        "type": "string",
        "description": "The currency code for the price, formatted according to ISO 4217 standard (e.g., EUR, GBP, etc.)."
      },
      "quantity": {
        "type": "integer",
        "description": "The quantity of the product (e.g., 5)."
      },
      "productCondition": {
        "type": "string",
        "description": "The condition of the product, whether it is used or new (e.g., New, Used)."
      },
      "totalOwed": {
        "type": "number",
        "description": "The total price of the order including all charges and discounts (e.g., 21.39)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "marketplace",
      "eventDate",
      "orderDate"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "FR",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "orderDate": "2021-02-08T11:04:43.305Z",
    "productName": "Amazon Fire HD 10 tablet, 1080p Full HD, 32 GB, latest model (2021 release), Lavender",
    "website": "Amazon.fr",
    "orderId": "701-7195934-7003458",
    "currencyCode": "EUR",
    "quantity": 1,
    "productCondition": "New",
    "totalOwed": 21.39
  }
]

Physical product subscriptions

This scope includes Amazon customer's list of physical product subscriptions with details like quantity of the subscribed items, their frequency, and alternate products if subscribed items are unavailable.

Identifiers:

  • Login with Amazon Scope Name: portability::physical_subscriptions
  • Amazon Data Portability scopeId : portability-physical-subscriptions

Physical product subscriptions

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
website The friendly name of the marketplace where the subscription was created. Amazon.de
productTitle The product title of the subscribed item. Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 1 Cube Box, 60 Tissues per Box
frequency The frequency interval of the subscription. 2 MONTH
quantity The quantity of subscribed items. 2
subscriptionState The current status of the subscription. ACTIVE
statusChangeDate The date when subscription state changed, in the ISO 8601 date-time format and UTC time zone. 2021-09-29T11:04:43.305Z
merchant The merchant identifier for the subscribed item. Amazon.de
backupProductTitle The backup product title of the subscribed item. Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 4 Flat Boxes, 120 Tissues per Box
backupMerchant The backup merchant identifier of the subscribed item. Amazon.de

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Physical Product Subscriptions",
  "description": "Includes the list of customers' physical product subscriptions, with details such as quantity of the subscribed items, their frequency or alternate products if subscribed items are unavailable.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string"
      },
      "website": {
        "type": "string",
        "description": "The friendly name of the marketplace where the subscription was created (e.g., Amazon.de)."
      },
      "productTitle": {
        "description": "The product title of the subscribed item (e.g., Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 1 Cube Box, 60 Tissues per Box).",
        "type": "string"
      },
      "frequency": {
        "description": "The frequency interval of the subscription (e.g., 2 MONTH).",
        "type": "string"
      },
      "quantity": {
        "description": "The quantity of subscribed items (e.g., 2).",
        "type": "number"
      },
      "subscriptionState": {
        "description": "The current status of the subscription (e.g., ACTIVE).",
        "type": "string",
        "enum": [
          "ACTIVE",
          "CANCELED",
          "INACTIVE",
          "STOPPED",
          "DELETED"
        ]
      },
      "statusChangeDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when subscription state changed, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "merchant": {
        "description": "The merchant identifier for the subscribed item (e.g., Amazon.de).",
        "type": "string"
      },
      "backupProductTitle": {
        "description": "The backup product title of the subscribed item (e.g., Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 4 Flat Boxes, 120 Tissues per Box).",
        "type": "string"
      },
      "backupMerchant": {
        "description": "The backup merchant identifier of the subscribed item (e.g., Amazon.de).",
        "type": "string"
      }
    },
    "required": [
      "marketplace",
      "eventDate",
      "productTitle"
    ],
    "unevaluatedProperties": false
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "website": "Amazon.de",
    "productTitle": "Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 1 Cube Box, 60 Tissues per Box",
    "frequency": "2 MONTH",
    "quantity": 2,
    "subscriptionState": "ACTIVE",
    "statusChangeDate": "2021-09-29T11:04:43.305Z",
    "merchant": "Amazon.de",
    "backupProductTitle": "Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 4 Flat Boxes, 120 Tissues per Box",
    "backupMerchant": "Amazon.de"
  }
]

Product substitution preferences

This scope includes Amazon customer's list of products that can be substituted by other products and their preferred substitute product.

Identifiers:

  • Login with Amazon Scope Name: portability::substitution_preferences
  • Amazon Data Portability scopeId : portability-substitution-preferences

Product substitution preferences

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
asin The identifier of the product for which substitution preferences were configured, a unique ten-digit alphanumeric code. B0CJ3J2WCR
productName The title of the product for which substitution preferences were configured. Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 1 Cube Box, 60 Tissues per Box
replacementAsin The identifier of the product selected as a preferred substitution, a unique ten-digit alphanumeric code. B08PDRXH59
replacementProductName The title of the product selected as a preferred substitution. Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 4 Flat Boxes, 120 Tissues per Box

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Product Substitution Preferences",
  "description": "Includes the list of products that can be substituted by other products and their preferred substitute product.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "marketplace": {
        "pattern": "^[A-Z]{2}$",
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "asin": {
        "type": "string",
        "description": "The identifier of the product for which substitution preferences were configured, a unique ten-digit alphanumeric code (e.g., B0CJ3J2WCR)."
      },
      "productName": {
        "type": "string",
        "description": "The title of the product for which substitution preferences were configured (e.g., Kleenex Soothing Lotion Facial Tissues with Coconut Oil, Aloe & Vitamin E, 1 Cube Box, 60 Tissues per Box)."
      },
      "replacementAsin": {
        "type": "string",
        "description": "The identifier of the product selected as a preferred substitution, a unique ten-digit alphanumeric code (e.g., B08PDRXH59)."
      },
      "replacementProductName": {
        "type": "string",
        "description": "The title of the product selected as a preferred substitution (e.g., Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 4 Flat Boxes, 120 Tissues per Box)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "marketplace",
      "eventDate",
      "asin",
      "productName",
      "replacementAsin",
      "replacementProductName"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "asin": "B0CJ3J2WCR",
    "productName": "Kleenex Soothing Lotion Facial Tissues with Coconut Oil, Aloe & Vitamin E, 1 Cube Box, 60 Tissues per Box",
    "replacementAsin": "B08PDRXH59",
    "replacementProductName": "Kleenex Soothing Lotion Facial Tissues with Coconut Oil, 4 Flat Boxes, 120 Tissues per Box"
  }
]

Search history

This scope includes Amazon customer's search queries and details like the device and application used to initiate the search, and also the list of search result product identifiers that were clicked by the customer or added to their shopping basket.

Identifiers:

  • Login with Amazon Scope Name: portability::search_insights
  • Amazon Data Portability scopeId : portability-search-insights

Search history products

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
clickedAsins The comma delimited list of unique product identifiers that were clicked as a result of this impression. B0CJ3J2WCR,B08PDRXH59
addedAsins The comma delimited list of unique product identifiers that were added as a result of this impression. B0873YHGDW,B0873YHGDW

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Search History - Products",
  "description": "Includes the list of search result products that were clicked or added to the cart by the customer.",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "marketplace",
      "eventDate"
    ],
    "unevaluatedProperties": false,
    "properties": {
      "marketplace": {
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "type": "string"
      },
      "eventDate": {
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "clickedAsins": {
        "description": "The comma delimited list of unique product identifiers that were clicked as a result of this impression (e.g., B0CJ3J2WCR, B08PDRXH59).",
        "type": "string"
      },
      "addedAsins": {
        "description": "The comma delimited list of unique product identifiers that were added as a result of this impression (e.g., B0873YHGDW,B0873YHGDW).",
        "type": "string"
      }
    }
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "clickedAsins": "B0CJ3J2WCR, B08PDRXH59",
    "addedAsins": "B0873YHGDW,B0873YHGDW"
  }
]

Search history queries

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
applicationName The name of the client-side application initiating the request. Prime Video
operatingSystemName The name of the OS on the client initiating the request. blast
operatingSystemVersion The version of the OS on the client initiating the request. 13.0
deviceName The name of the device making the request. Generic Smart TV
keywords The full text entered in the keyword search box, or empty string if no keywords were entered. bipolar
server The name of server. www.amazon.de
aliases The list of search alias used in the query group. instant-video
firstSearchDomain The domain of the first search of the query group. www.google.com

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Search History - Queries",
  "description": "Includes the search queries initiated by the customer, including details such as the device and application used to initiate the search.",
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "marketplace",
      "eventDate"
    ],
    "unevaluatedProperties": false,
    "properties": {
      "marketplace": {
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "type": "string"
      },
      "eventDate": {
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "applicationName": {
        "description": "The name of the client-side application initiating the request (e.g., Prime Video).",
        "type": "string"
      },
      "operatingSystemName": {
        "description": "The name of the OS on the client initiating the request (e.g., blast).",
        "type": "string"
      },
      "operatingSystemVersion": {
        "description": "The version of the OS on the client initiating the request (e.g., 13.0).",
        "type": "string"
      },
      "deviceName": {
        "description": "The name of the device making the request (e.g., Generic Smart TV).",
        "type": "string"
      },
      "keywords": {
        "description": "The full text entered in the keyword search box, or empty string if no keywords were entered (e.g., bipolar).",
        "type": "string"
      },
      "server": {
        "description": "The name of server (e.g., www.amazon.de).",
        "type": "string"
      },
      "aliases": {
        "description": "The list of search alias used in the query group (e.g., instant-video).",
        "type": "string"
      },
      "firstSearchDomain": {
        "description": "The domain of the first search of the query group (e.g., www.google.com).",
        "type": "string"
      }
    }
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "applicationName": "Prime Video",
    "operatingSystemName": "blast",
    "operatingSystemVersion": "13.0",
    "deviceName": "Generic Smart TV",
    "keywords": "bipolar",
    "server": "www.amazon.de",
    "aliases": "instant-video",
    "firstSearchDomain": "www.google.com"
  }
]

Shopping basket

This scope includes Amazon customer's products added to their shopping basket with details like their quantity and the date when they were added.

Identifiers:

  • Login with Amazon Scope Name: portability::orders_cart
  • Amazon Data Portability scopeId : portability-orders-cart

Shopping basket

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
dateAddedToCart The date when the record was added to cart, in the ISO 8601 date-time format and UTC time zone. 2021-09-29T11:04:43.305Z
asin The identifier of the purchased product, a unique ten-digit alphanumeric code. B008RLDGLO
cartList The state indicating if the item is in the customer's cart, and will be included in the order when the customer proceeds to checkout. active
quantity The quantity of the item added in the cart. 5

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Basket",
  "description": "Includes products added to the customer's shopping basket with details such as their quantity or the date they were added.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was added to cart, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "dateAddedToCart": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was added to cart, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      },
      "marketplace": {
        "type": "string",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE).",
        "pattern": "^[A-Z]{2}$"
      },
      "asin": {
        "type": "string",
        "description": "The identifier of the purchased product, a unique ten-digit alphanumeric code (e.g., B008RLDGLO)."
      },
      "cartList": {
        "type": "string",
        "description": "The state indicating if the item is in the customer's cart, and will be included in the order when the customer proceeds to checkout (e.g., active)."
      },
      "quantity": {
        "type": "integer",
        "description": "The quantity of the item added in the cart (e.g., 5)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "marketplace",
      "eventDate",
      "dateAddedToCart"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "dateAddedToCart": "2021-09-29T11:04:43.305Z",
    "asin": "B008RLDGLO",
    "cartList": "active",
    "quantity": 1
  }
]

Shopping profile preferences

This scope includes Amazon customer's shopping preferences with regard to details like beauty products, apparel style, fit, and sustainability.

Identifiers:

  • Login with Amazon Scope Name: portability::shopping_preferences
  • Amazon Data Portability scopeId : portability-shopping-preferences

Shopping preferences - beauty

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
skinTypes The skin types. N/A
skinTypes.category The category of the skin type. face
skinTypes.response The value of the skin type. dry
skinConcerns The skin concerns. N/A
skinConcerns.category The category of the skin concern. eyes
skinConcerns.response The value of the skin concern. hydration
skinAge The age of skin in bands of 10. 30-39
skinTone The tone of the skin. fair
skinCharacteristics The skin characteristics. N/A
skinCharacteristics.category The category of the skin characteristic. sensitive
skinCharacteristics.response The value of the skin characteristic. yes
productPreferences The beauty product preferences. N/A
productPreferences.category The category of the product preference. general
productPreferences.response The value of the product preference. organic
preferredDepartments The preferred department for shopping for beauty products. N/A
preferredDepartments.category The category of the preferred department. general
preferredDepartments.response The value of the preferred department. womens
preferenceFrequencies The frequency of collecting beauty preferences. N/A
preferenceFrequencies.category The category of the preference frequency. premium
preferenceFrequencies.response The value of the preference frequency. always

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Beauty",
  "description": "Includes beauty shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "anyOf": [
    {
      "required": [
        "skinTypes",
        "eventDate"
      ]
    },
    {
      "required": [
        "skinConcerns",
        "eventDate"
      ]
    },
    {
      "required": [
        "skinAge",
        "eventDate"
      ]
    },
    {
      "required": [
        "skinTone",
        "eventDate"
      ]
    },
    {
      "required": [
        "skinCharacteristics",
        "eventDate"
      ]
    },
    {
      "required": [
        "productPreferences",
        "eventDate"
      ]
    },
    {
      "required": [
        "preferredDepartments",
        "eventDate"
      ]
    },
    {
      "required": [
        "preferenceFrequencies",
        "eventDate"
      ]
    }
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "skinTypes": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The skin types.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "response"
        ],
        "properties": {
          "category": {
            "type": "string",
            "description": "The category of the skin type (e.g., face).",
            "enum": [
              "face"
            ]
          },
          "response": {
            "type": "string",
            "description": "The value of the skin type (e.g., dry).",
            "enum": [
              "oily",
              "normal",
              "combination",
              "dry",
              "No_Response"
            ]
          }
        }
      }
    },
    "skinConcerns": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The skin concerns.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "response"
        ],
        "properties": {
          "category": {
            "type": "string",
            "description": "The category of the skin concern (e.g., eyes).",
            "enum": [
              "top",
              "general",
              "eyes"
            ]
          },
          "response": {
            "type": "array",
            "description": "The value of the skin concern (e.g., hydration).",
            "uniqueItems": true,
            "minItems": 1,
            "contains": {
              "type": "string",
              "enum": [
                "fine_lines",
                "anti-aging",
                "acne",
                "wrinkles",
                "dark_circles",
                "dull_skin",
                "dark_spots",
                "pore_size",
                "age_spots",
                "redness",
                "hydration",
                "roughness",
                "sagging",
                "puffiness",
                "dryness",
                "bags",
                "brightening",
                "pigmentation",
                "No_Response"
              ]
            }
          }
        }
      }
    },
    "skinAge": {
      "type": "array",
      "description": "The age of skin in bands of 10 (e.g., 30-39).",
      "uniqueItems": true,
      "minItems": 1,
      "maxItems": 1,
      "items": {
        "type": "string",
        "enum": [
          "under_20",
          "20-29",
          "30-39",
          "40-49",
          "50-59",
          "60-and-above",
          "No_Response"
        ]
      }
    },
    "skinTone": {
      "type": "array",
      "description": "The tone of the skin (e.g., fair).",
      "uniqueItems": true,
      "minItems": 1,
      "maxItems": 1,
      "items": {
        "type": "string",
        "enum": [
          "very_fair",
          "fair",
          "medium",
          "medium_dark",
          "dark",
          "very_dark",
          "No_Response"
        ]
      }
    },
    "skinCharacteristics": {
      "type": "array",
      "description": "The skin characteristics.",
      "uniqueItems": true,
      "minItems": 1,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "response"
        ],
        "properties": {
          "category": {
            "description": "The category of the skin characteristic (e.g., sensitive).",
            "type": "string",
            "enum": [
              "sensitive"
            ]
          },
          "response": {
            "description": "The value of the skin characteristic (e.g., yes).",
            "type": "string",
            "enum": [
              "yes",
              "no",
              "No_Response"
            ]
          }
        }
      }
    },
    "productPreferences": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The beauty product preferences.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "response"
        ],
        "properties": {
          "category": {
            "description": "The category of the product preference (e.g., general).",
            "type": "string",
            "enum": [
              "free-of",
              "general"
            ]
          },
          "response": {
            "description": "The value of the product preference (e.g., organic).",
            "type": "array",
            "uniqueItems": true,
            "minItems": 1,
            "contains": {
              "type": "string",
              "enum": [
                "no-artificial-colors",
                "natural",
                "organic",
                "vegan",
                "sustainable",
                "fragrance-free",
                "hypoallergenic",
                "paraben-free",
                "cruelty-free",
                "oil-free",
                "alcohol-free",
                "phthalate-free",
                "sulfate-free",
                "gluten-free",
                "mineral-oil-free",
                "silicone-free",
                "surfactant-free",
                "uv-absorber-free",
                "allergy-tested",
                "no-comedogenic",
                "made-in-country",
                "ayurvedic",
                "No_Response"
              ]
            }
          }
        }
      }
    },
    "preferredDepartments": {
      "type": "array",
      "description": "The preferred department for shopping for beauty products.",
      "uniqueItems": true,
      "minItems": 1,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "response"
        ],
        "properties": {
          "category": {
            "description": "The category of the preferred department (e.g., general).",
            "type": "string",
            "enum": [
              "general"
            ]
          },
          "response": {
            "description": "The value of the preferred department (e.g., womens).",
            "type": "array",
            "uniqueItems": true,
            "minItems": 1,
            "items": {
              "type": "string",
              "enum": [
                "mens",
                "womens",
                "No_Response"
              ]
            }
          }
        }
      }
    },
    "preferenceFrequencies": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The frequency of collecting beauty preferences.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "response"
        ],
        "properties": {
          "category": {
            "description": "The category of the preference frequency (e.g., premium).",
            "type": "string",
            "enum": [
              "premium"
            ]
          },
          "response": {
            "description": "The value of the preference frequency (e.g., always).",
            "type": "string",
            "enum": [
              "always",
              "often",
              "sometimes",
              "rarely",
              "never",
              "No_Response"
            ]
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "skinTypes": [
    {
      "category": "face",
      "response": "dry"
    }
  ]
}

Shopping preferences - profile

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
gender The gender. male
height The height. N/A
height.length The height value. 160
height.unit The height unit. cm
weight The weight. N/A
weight.mass The weight value. 50
weight.unit The weight unit. kg
weightUnitSystem The unit system that customers prefer for storing weight. imperial
heightUnitSystem The unit system that customers prefer for storing height. imperial
unitSystem The unit system that customers prefer for storing height. imperial

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Profile",
  "description": "Includes profile shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "anyOf": [
    {
      "required": [
        "gender",
        "eventDate"
      ]
    },
    {
      "required": [
        "height",
        "eventDate"
      ]
    },
    {
      "required": [
        "weight",
        "eventDate"
      ]
    },
    {
      "required": [
        "weightUnitSystem",
        "eventDate"
      ]
    },
    {
      "required": [
        "heightUnitSystem",
        "eventDate"
      ]
    },
    {
      "required": [
        "unitSystem",
        "eventDate"
      ]
    }
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "gender": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1,
      "description": "The gender (e.g., male).",
      "items": {
        "type": "string",
        "enum": [
          "male",
          "female"
        ]
      }
    },
    "height": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "maxItems": 1,
      "description": "The height.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "length",
          "unit"
        ],
        "properties": {
          "length": {
            "description": "The height value (e.g., 160).",
            "type": "number",
            "minimum": 0
          },
          "unit": {
            "description": "The height unit (e.g., cm).",
            "type": "string",
            "enum": [
              "cm",
              "in"
            ]
          }
        }
      }
    },
    "weight": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "maxItems": 1,
      "description": "The weight.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "mass",
          "unit"
        ],
        "properties": {
          "mass": {
            "description": "The weight value (e.g., 50).",
            "type": "number",
            "minimum": 0
          },
          "unit": {
            "description": "The weight unit (e.g., kg).",
            "type": "string",
            "enum": [
              "kg"
            ]
          }
        }
      }
    },
    "weightUnitSystem": {
      "type": "array",
      "description": "The unit system that customers prefer for storing weight (e.g., imperial).",
      "items": {
        "type": "string",
        "enum": [
          "imperial",
          "metric"
        ]
      }
    },
    "heightUnitSystem": {
      "type": "array",
      "description": "The unit system that customers prefer for storing height (e.g., imperial).",
      "items": {
        "type": "string",
        "enum": [
          "imperial",
          "metric"
        ]
      }
    },
    "unitSystem": {
      "type": "array",
      "description": "The unit system that customers prefer for storing height (e.g., imperial).",
      "items": {
        "type": "string",
        "enum": [
          "imperial",
          "metric"
        ]
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "gender": [
    "male"
  ],
  "height": [
    {
      "length": 120,
      "unit": "cm"
    }
  ],
  "weight": [
    {
      "mass": 50,
      "unit": "kg"
    }
  ],
  "weightUnitSystem": [
    "imperial"
  ],
  "heightUnitSystem": [
    "imperial"
  ],
  "unitSystem": [
    "imperial"
  ]
}

Shopping preferences - apparel style

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
styleAesthetics The style aesthetics preferences. N/A
styleAesthetics.department The department of the style aesthetics. mens
styleAesthetics.category The category of the style aesthetics. sporty
styleAesthetics.response The value of the style aesthetics. often
categoryFrequency The frequency in which customer likes to shop in different ptd groups. N/A
categoryFrequency.department The department of the category frequency. womens
categoryFrequency.category The category of the category frequency. skirts
categoryFrequency.response The value of the category frequency. often
patternsPreferences The preferred apparel patterns. N/A
patternsPreferences.department The department of the pattern preferences. womens
patternsPreferences.category The category of the pattern preferences. preferred-patterns
patternsPreferences.response The value of the pattern preferences. floral
colorsPreferences The preferred apparel colors. N/A
colorsPreferences.department The department of the color preference. mens
colorsPreferences.category The category of the color preference. preferred-colors
colorsPreferences.response The value of the color preference. red
preferredShoppingDepartments The preferred shopping departments. mens
trendsInterests The preferred trend interests. N/A
trendsInterests.department The department of the trend interest. womens
trendsInterests.category The category of the trend interest. seasonal-new-trends
trendsInterests.response The value of the trend interest. somewhat-interested

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Apparel Style",
  "description": "Includes the apparel style shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "anyOf": [
    {
      "required": [
        "styleAesthetics",
        "eventDate"
      ]
    },
    {
      "required": [
        "categoryFrequency",
        "eventDate"
      ]
    },
    {
      "required": [
        "patternsPreferences",
        "eventDate"
      ]
    },
    {
      "required": [
        "colorsPreferences",
        "eventDate"
      ]
    },
    {
      "required": [
        "preferredShoppingDepartments",
        "eventDate"
      ]
    },
    {
      "required": [
        "trendsInterests",
        "eventDate"
      ]
    }
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "styleAesthetics": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The style aesthetics preferences.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The department of the style aesthetics (e.g., mens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the style aesthetics (e.g., sporty).",
            "type": "string",
            "enum": [
              "casual",
              "edgy",
              "classic",
              "romantic",
              "sporty",
              "glam",
              "minimal",
              "boho",
              "androgynous",
              "retro",
              "active",
              "business-casual",
              "everyday-comfort",
              "outdoor-casual",
              "No_Response"
            ]
          },
          "response": {
            "description": "The value of the style aesthetics (e.g., often).",
            "type": "string",
            "enum": [
              "always",
              "often",
              "sometimes",
              "rarely",
              "never",
              "No_Response"
            ]
          }
        }
      }
    },
    "categoryFrequency": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The frequency in which customer likes to shop in different ptd groups.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The department of the category frequency (e.g., womens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the category frequency (e.g., skirts).",
            "type": "string",
            "enum": [
              "dresses",
              "skirts",
              "jeans",
              "pants",
              "shorts",
              "leggings",
              "button-down-shirts"
            ]
          },
          "response": {
            "description": "The value of the category frequency (e.g., often).",
            "type": "string",
            "enum": [
              "always",
              "often",
              "sometimes",
              "rarely",
              "never",
              "No_Response"
            ]
          }
        }
      }
    },
    "patternsPreferences": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The preferred apparel patterns.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The department of the pattern preferences (e.g., womens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the pattern preferences (e.g., preferred-patterns).",
            "type": "string",
            "enum": [
              "preferred-patterns",
              "avoid-patterns"
            ]
          },
          "response": {
            "description": "The value of the pattern preferences (e.g., floral).",
            "type": "array",
            "uniqueItems": true,
            "minItems": 1,
            "contains": {
              "type": "string",
              "enum": [
                "animal",
                "floral",
                "geometric",
                "graphic",
                "plaid",
                "polkadot",
                "stripes",
                "tiedye",
                "microfloral",
                "bold-florals",
                "check",
                "logos",
                "horizontal-stripes",
                "vertical-stripes",
                "critters",
                "novelty",
                "No_Response"
              ]
            }
          }
        }
      }
    },
    "colorsPreferences": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The preferred apparel colors.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The department of the color preference (e.g., mens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the color preference (e.g., preferred-colors).",
            "type": "string",
            "enum": [
              "preferred-colors",
              "avoid-colors"
            ]
          },
          "response": {
            "description": "The value of the color preference (e.g., red).",
            "type": "array",
            "uniqueItems": true,
            "minItems": 1,
            "contains": {
              "type": "string",
              "enum": [
                "blacks",
                "blues",
                "browns",
                "gold",
                "gray",
                "green",
                "multi",
                "neutral",
                "orange",
                "pink",
                "purple",
                "red",
                "silver",
                "yellow",
                "navy",
                "light-blue",
                "No_Response"
              ]
            }
          }
        }
      }
    },
    "preferredShoppingDepartments": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The preferred shopping departments (e.g., mens).",
      "items": {
        "type": "array",
        "additionalProperties": false,
        "contains": {
          "type": "string",
          "enum": [
            "mens",
            "womens",
            "No_Response"
          ]
        }
      }
    },
    "trendsInterests": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The preferred trend interests.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The department of the trend interest (e.g., womens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the trend interest (e.g., seasonal-new-trends).",
            "type": "string",
            "enum": [
              "seasonal-new-trends"
            ]
          },
          "response": {
            "description": "The value of the trend interest (e.g., somewhat-interested).",
            "type": "string",
            "enum": [
              "very-interested",
              "somewhat-interested",
              "not-interested",
              "No_Response"
            ]
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "styleAesthetics": [
    {
      "department": "mens",
      "category": "sporty",
      "response": "often"
    }
  ],
  "categoryFrequency": [
    {
      "department": "womens",
      "category": "skirts",
      "response": "often"
    }
  ],
  "patternsPreferences": [
    {
      "department": "womens",
      "category": "preferred-patterns",
      "response": [
        "floral"
      ]
    }
  ],
  "colorsPreferences": [
    {
      "department": "mens",
      "category": "preferred-colors",
      "response": [
        "red"
      ]
    }
  ],
  "preferredShoppingDepartments": [
    [
      "mens"
    ]
  ],
  "trendsInterests": [
    {
      "department": "womens",
      "category": "seasonal-new-trends",
      "response": "somewhat-interested"
    }
  ]
}

Shopping preferences - shoes apparel size

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
sizePreferences The shoes and apparel size preferences. N/A
sizePreferences.department The department of the size preference. womens
sizePreferences.category The category of the size preference. shoes
sizePreferences.sizeScheme The size scheme of the size preference. US
sizePreferences.sizeNumeric The size numeric of the size preference. 9
sizePreferences.sizeAlphanumeric The size alphanumeric of the size preference. x-large
sizePreferences.normalizedSize The normalized size of the size preference. N/A
sizePreferences.normalizedSize.size The normalized size value of the size preference. 5
sizePreferences.normalizedSize.dimensionType The normalized size dimension type of the size preference. primary
sizePreferences.modifier The modifier of the size preference. wide
sizePreferences.brand The brand of the size preference. gap

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Shoes Apparel Size",
  "description": "Includes the shoes apparel size shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "required": [
    "eventDate",
    "sizePreferences"
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "sizePreferences": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The shoes and apparel size preferences.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "sizeScheme"
        ],
        "properties": {
          "department": {
            "description": "The department of the size preference (e.g., womens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the size preference (e.g., shoes).",
            "type": "string",
            "enum": [
              "global",
              "tops",
              "coats-jackets-vests",
              "pants",
              "jeans",
              "dresses::dresses-and-skirts",
              "shoes",
              "button-down-shirts",
              "blazers-and-sports-jackets",
              "t-shirts::t-shirts-and-sweaters",
              "bras"
            ]
          },
          "sizeScheme": {
            "description": "The size scheme of the size preference (e.g., US).",
            "type": "string",
            "pattern": "^[A-Z]{2}$"
          },
          "sizeNumeric": {
            "description": "The size numeric of the size preference (e.g., 9).",
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "number",
              "minimum": 0
            }
          },
          "sizeAlphanumeric": {
            "description": "The size alphanumeric of the size preference (e.g., x-large).",
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string",
              "enum": [
                "00",
                "6x-small",
                "5x-small",
                "4x-small",
                "3x-small",
                "xx-small",
                "x-small",
                "small",
                "medium",
                "large",
                "x-large",
                "xx-large",
                "3x-large",
                "4x-large",
                "5x-large",
                "6x-large",
                "7x-large",
                "1x",
                "2x",
                "3x",
                "4x",
                "5x",
                "6x",
                "7x",
                "Not_Listed"
              ]
            }
          },
          "normalizedSize": {
            "description": "The normalized size of the size preference.",
            "type": "object",
            "additionalProperties": false,
            "required": [
              "size",
              "dimensionType"
            ],
            "properties": {
              "size": {
                "description": "The normalized size value of the size preference (e.g., 5).",
                "type": "number"
              },
              "dimensionType": {
                "description": "The normalized size dimension type of the size preference (e.g., primary).",
                "type": "string",
                "enum": [
                  "primary",
                  "length",
                  "width"
                ]
              }
            }
          },
          "modifier": {
            "description": "The modifier of the size preference (e.g., wide).",
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string",
              "enum": [
                "narrow",
                "standard",
                "wide",
                "short",
                "regular",
                "long"
              ]
            }
          },
          "brand": {
            "description": "The brand of the size preference (e.g., gap).",
            "type": "string",
            "enum": [
              "7-for-all-mankind",
              "adidas",
              "ag-adriano-goldschmied",
              "aldo",
              "allen-edmonds",
              "allen-solly",
              "alo-yoga",
              "amazon-brand-symbol",
              "amazon-essentials",
              "american-eagle-outfitters",
              "anne-klein",
              "armani-exchange",
              "asos",
              "avec-les-filles",
              "badgley-mischka",
              "banana-republic",
              "bcbg-max-azria",
              "ben-sherman",
              "billy-reid",
              "black-halo",
              "boohoo",
              "buttoned-down",
              "c-and-a",
              "calvin-klein",
              "carhartt",
              "chaps",
              "chaser",
              "city-chic",
              "clarks",
              "club-monaco",
              "cole-haan",
              "columbia",
              "converse",
              "core-10",
              "daily-ritual",
              "dc",
              "democracy",
              "dennis-lingo",
              "dickies",
              "diesel",
              "dl1961",
              "dockers",
              "dr-martens",
              "ecco",
              "eddie-bauer",
              "express",
              "fab-india",
              "florsheim",
              "forever-21",
              "french-connection",
              "frye",
              "gap",
              "global-desi",
              "global-work",
              "good-man-brand",
              "goodthreads",
              "gosriki",
              "gu",
              "h-and-m",
              "helly-hansen",
              "hugo-boss",
              "hurley",
              "izod",
              "janasya",
              "janina",
              "jcrew",
              "joes-jeans",
              "john-varvatos",
              "joie",
              "journal-standard",
              "kenneth-cole",
              "lacoste",
              "lark-and-ro",
              "levis",
              "loeffler-randall",
              "lucky-brand",
              "marc-jacobs",
              "marks-and-spencer",
              "marmot",
              "matalan",
              "max-fashion",
              "milly",
              "mizzen-plus-main",
              "muji",
              "nano-universe",
              "nautica",
              "new-balance",
              "new-look",
              "new-yorker",
              "next",
              "nike",
              "niko-and-dotdotdot",
              "nine-west",
              "nydj",
              "obey",
              "old-navy",
              "original-penguin",
              "paige",
              "parker",
              "pendleton",
              "pour-la-victoire",
              "primark",
              "puma",
              "quiksilver",
              "rebecca-taylor",
              "reebok",
              "rekucci",
              "rip-curl",
              "s-oliver",
              "sam-edelman",
              "seven7",
              "shimamura",
              "siril",
              "soludos",
              "sperry",
              "splendid",
              "star-vixen",
              "steve-madden",
              "stuart-weitzman",
              "superga",
              "takko",
              "tcm",
              "ted-baker",
              "the-drop",
              "the-kooples",
              "theory",
              "timberland",
              "tommy-hilfiger",
              "toms",
              "topshop",
              "ugg",
              "under-armour",
              "uniqlo",
              "united-arrows",
              "untuckit",
              "urban-research",
              "us-polo-assn",
              "van-heusen",
              "vero-moda",
              "vince",
              "vince-camuto",
              "vineyard-vines",
              "zanerobe",
              "zara",
              "Not_Listed"
            ]
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "sizePreferences": [
    {
      "department": "womens",
      "category": "shoes",
      "sizeScheme": "US",
      "sizeNumeric": [
        9
      ],
      "sizeAlphanumeric": [
        "x-large"
      ],
      "normalizedSize": {
        "size": 5,
        "dimensionType": "primary"
      },
      "modifier":["wide"],
      "brand":"gap"
    }
  ]
}

Shopping preferences - interests

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
interestPreferences The interest preferences. N/A
interestPreferences.interestName The interest name. star-wars
interestPreferences.interestMetadata The interest metadata. N/A
interestPreferences.interestMetadata.responseMarketplaceId The interest metadata marketplace identifier. DE
interestPreferences.interestMetadata.responseTimestamp The interest metadata response timestamp. 2023-11-28T21:54:11.310Z
interestPreferences.interestMetadata.responseSource The interest metadata response source. N/A
interestPreferences.interestMetadata.responseSource.deviceType The interest metadata response source device type. mobile
interestPreferences.interestMetadata.responseSource.pageType The interest metadata response source page type. fan-shop
interestPreferences.interestMetadata.responseSource.experienceType The interest metadata response source experience type. adder
interestPreferences.interestMetadata.responseSource.sourceType The interest metadata response source type. N/A
interestPreferences.interestMetadata.responseSource.sourceType.modelVersion The interest metadata response source type model version. 2
interestPreferences.interestMetadata.responseSource.sourceType.source The interest metadata response source type value. behavior-based-sustainability-targeting-model

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Interests",
  "description": "Includes the interests shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "required": [
    "eventDate",
    "interestPreferences"
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "interestPreferences": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The interest preferences.",
      "items": {
        "type": "object",
        "required": [
          "interestName",
          "interestMetadata"
        ],
        "properties": {
          "interestName": {
            "description": "The interest name (e.g., star-wars).",
            "type": "string"
          },
          "interestMetadata": {
            "description": "The interest metadata.",
            "type": "object",
            "required": [
              "response",
              "responseMarketplaceId",
              "responseTimestamp",
              "responseSource"
            ],
            "properties": {
              "response": {
                "type": "string",
                "enum": [
                  "yes",
                  "no"
                ]
              },
              "responseMarketplaceId": {
                "description": "The interest metadata marketplace identifier (e.g., DE).",
                "type": "string",
                "pattern": "^[A-Z]{2}$"
              },
              "responseTimestamp": {
                "description": "The interest metadata response timestamp (e.g., 2023-11-28T21:54:11.310Z).",
                "type": "string",
                "format": "date-time"
              },
              "responseSource": {
                "description": "The interest metadata response source.",
                "type": "object",
                "properties": {
                  "deviceType": {
                    "description": "The interest metadata response source device type (e.g., mobile).",
                    "type": "string",
                    "enum": [
                      "mobile",
                      "desktop",
                      "unknown"
                    ]
                  },
                  "pageType": {
                    "description": "The interest metadata response source page type (e.g., fan-shop).",
                    "type": "string",
                    "enum": [
                      "browse",
                      "cart",
                      "detail",
                      "fan-shop",
                      "gateway",
                      "inspire",
                      "shop-by-interest",
                      "me-tab",
                      "personalized-interest",
                      "profile-hub",
                      "search",
                      "thank-you",
                      "your-interests"
                    ]
                  },
                  "experienceType": {
                    "description": "The interest metadata response source experience type (e.g., adder).",
                    "type": "string",
                    "enum": [
                      "adder",
                      "banner",
                      "confirmation-card",
                      "follow-button",
                      "pop-up",
                      "profile-hub",
                      "profile-picker"
                    ]
                  },
                  "sourceType": {
                    "description": "The interest metadata response source type.",
                    "type": "object",
                    "properties": {
                      "source": {
                        "description": "The interest metadata response source type value (e.g., behavior-based-sustainability-targeting-model).",
                        "type": "string",
                        "enum": [
                          "location",
                          "search-history",
                          "product-view-history",
                          "purchase-history",
                          "purchase-action",
                          "behavior-based-sustainability-targeting-model",
                          "behavior-based-targeting-model",
                          "add-to-cart-action"
                        ]
                      },
                      "modelVersion": {
                        "description": "The interest metadata response source type model version (e.g., 2).",
                        "type": "number"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "interestPreferences": [
    {
      "interestName": "star-wars",
      "interestMetadata": {
        "response": "yes",
        "responseMarketplaceId": "DE",
        "responseTimestamp": "2023-11-28T21:54:11.310Z",
        "responseSource": {
          "deviceType": "mobile",
          "pageType": "fan-shop",
          "experienceType": "adder",
          "sourceType": {
            "source": "behavior-based-sustainability-targeting-model",
            "modelVersion": 2
          }
        }
      }
    }
  ]
}

Shopping preferences - fit

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
fitPreferences The fit preferences. N/A
fitPreferences.department The fit preference department. mens
fitPreferences.category The fit preference category. tops
fitPreferences.response The fit preference response. fitted
fitConsiderations The fit considerations. N/A
fitConsiderations.department The fit considerations department. womens
fitConsiderations.category The fit considerations category. fit-consideration
fitConsiderations.response The fit considerations response. maternity
fitConsiderationResponses The fit consideration responses. N/A
fitConsiderationResponses.department The fit consideration responses department. womens
fitConsiderationResponses.category The fit consideration responses category. fit-consideration-response
fitConsiderationResponses.response The fit consideration responses response. Size is too small
fitMeasurements The fit measurements. N/A
fitMeasurements.category The fit measurements category. neck
fitMeasurements.measurement The fit measurements measurement. N/A
fitMeasurements.measurement.length The fit measurements measurement length. 34
fitMeasurements.measurement.unit The fit measurements measurement unit. in

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Fit",
  "description": "Includes the fit shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "anyOf": [
    {
      "required": [
        "fitPreferences",
        "eventDate"
      ]
    },
    {
      "required": [
        "fitConsiderations",
        "eventDate"
      ]
    },
    {
      "required": [
        "fitConsiderationResponses",
        "eventDate"
      ]
    },
    {
      "required": [
        "fitMeasurements",
        "eventDate"
      ]
    }
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "fitPreferences": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The fit preferences.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The fit preference department (e.g., mens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The fit preference category (e.g., tops).",
            "type": "string",
            "enum": [
              "tops",
              "pants::bottoms",
              "jeans",
              "dresses::dresses-and-skirts",
              "shoes::heel-height",
              "dresses::dress-silhouette",
              "button-down-shirts",
              "blazers-and-sports-jackets",
              "pants"
            ]
          },
          "response": {
            "description": "The fit preference response (e.g., fitted).",
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string",
              "enum": [
                "fitted",
                "loose",
                "straight",
                "above-knee",
                "knee-length",
                "long",
                "midi",
                "fit-flare",
                "maxi",
                "bootcut",
                "boyfriend",
                "cropped",
                "skinny",
                "wide",
                "flat",
                "high",
                "low",
                "medium",
                "slim",
                "classic",
                "relaxed",
                "No_Response"
              ]
            }
          }
        }
      }
    },
    "fitConsiderations": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The fit considerations.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The fit considerations department (e.g., womens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The fit considerations category (e.g., fit-consideration).",
            "type": "string",
            "enum": [
              "fit-consideration"
            ]
          },
          "response": {
            "description": "The fit considerations response (e.g., maternity).",
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string",
              "enum": [
                "maternity",
                "petite",
                "plus-size",
                "regular",
                "tall",
                "No_Response"
              ]
            }
          }
        }
      }
    },
    "fitConsiderationResponses": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The fit consideration responses.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The fit consideration responses department (e.g., womens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The fit consideration responses category (e.g., fit-consideration-response).",
            "type": "string",
            "enum": [
              "fit-consideration-response"
            ]
          },
          "response": {
            "description": "The fit consideration responses response (e.g., Size is too small).",
            "type": "string",
            "minLength": 1,
            "maxLength": 1024
          }
        }
      }
    },
    "fitMeasurements": {
      "type": "array",
      "additionalProperties": false,
      "description": "The fit measurements.",
      "items": {
        "required": [
          "category",
          "measurement"
        ],
        "type": "object",
        "properties": {
          "category": {
            "description": "The fit measurements category (e.g., neck).",
            "type": "string",
            "enum": [
              "neck",
              "sleeve",
              "waist",
              "bust",
              "chest",
              "hip",
              "inseam",
              "outseam",
              "shoulders",
              "ribcage"
            ]
          },
          "measurement": {
            "description": "The fit measurements measurement.",
            "type": "object",
            "additionalProperties": false,
            "required": [
              "length",
              "unit"
            ],
            "properties": {
              "length": {
                "description": "The fit measurements measurement length (e.g., 34).",
                "type": "number",
                "minimum": 0
              },
              "unit": {
                "description": "The fit measurements measurement unit (e.g., in).",
                "type": "string",
                "enum": [
                  "cm",
                  "in"
                ]
              }
            }
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "fitPreferences": [
    {
      "department": "mens",
      "category": "tops",
      "response": [
        "fitted"
      ]
    }
  ],
  "fitConsiderations": [
    {
      "department": "womens",
      "category": "fit-consideration",
      "response": [
        "maternity"
      ]
    }
  ],
  "fitConsiderationResponses": [
    {
      "department": "womens",
      "category": "fit-consideration-response",
      "response": "Size is too small"
    }
  ],
  "fitMeasurements": [
    {
      "category": "neck",
      "measurement": {
        "length": 34,
        "unit": "in"
      }
    }
  ]
}

Shopping preferences - events

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
promotionalEvent The promotional event preference. N/A
promotionalEvent.eventType The event type of the promotional event. thursday-night-football
promotionalEvent.eventChoice The event choice of the promotional event. dismiss

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Events",
  "description": "Includes the events shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "required": [
    "eventDate",
    "promotionalEvent"
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "promotionalEvent": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The promotional event preference.",
      "items": {
        "type": "object",
        "required": [
          "eventType",
          "eventChoice"
        ],
        "properties": {
          "eventType": {
            "description": "The event type of the promotional event (e.g., thursday-night-football).",
            "type": "string",
            "enum": [
              "back-to-school",
              "mothers-day",
              "thursday-night-football",
              "wedding"
            ]
          },
          "eventChoice": {
            "description": "The event choice of the promotional event (e.g., dismiss).",
            "type": "string",
            "enum": [
              "dismiss",
              "like",
              "no-preference"
            ]
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "promotionalEvent": [
    {
      "eventType": "thursday-night-football",
      "eventChoice": "dismiss"
    }
  ]
}

Shopping preferences - price

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
apparelPricePreferences The price range preferences. N/A
apparelPricePreferences.department The department of the apparel price preferences. mens
apparelPricePreferences.category The category of the apparel price preferences. shoes
apparelPricePreferences.minResponse The minimum of the apparel price preference. N/A
apparelPricePreferences.minResponse.amount The minimum value of the apparel price preference. 15
apparelPricePreferences.minResponse.currency The minimum currency of the apparel price preference. usd
apparelPricePreferences.maxResponse The maximum of the apparel price preference. N/A
apparelPricePreferences.maxResponse.amount The maximum value of the apparel price preference. 300
apparelPricePreferences.maxResponse.currency The maximum currency of the apparel price preference. usd

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Price",
  "description": "Includes the price shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "required": [
    "eventDate",
    "apparelPricePreferences"
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "apparelPricePreferences": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The price range preferences.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "minResponse",
          "maxResponse"
        ],
        "properties": {
          "department": {
            "description": "The department of the apparel price preferences (e.g., mens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the apparel price preferences (e.g., shoes).",
            "type": "string",
            "enum": [
              "tops",
              "coats-jackets-vests",
              "pants",
              "jeans",
              "dresses::dresses-and-skirts",
              "shoes",
              "sweaters",
              "t-shirts",
              "jackets-coats",
              "button-down-shirts",
              "blazers-and-sports-jackets"
            ]
          },
          "minResponse": {
            "description": "The minimum of the apparel price preference.",
            "type": "object",
            "additionalProperties": false,
            "required": [
              "amount",
              "currency"
            ],
            "properties": {
              "amount": {
                "description": "The minimum value of the apparel price preference (e.g., 15).",
                "type": "number"
              },
              "currency": {
                "description": "The minimum currency of the apparel price preference (e.g., usd).",
                "type": "string",
                "enum": [
                  "usd"
                ]
              }
            }
          },
          "maxResponse": {
            "description": "The maximum of the apparel price preference.",
            "type": "object",
            "additionalProperties": false,
            "required": [
              "amount",
              "currency"
            ],
            "properties": {
              "amount": {
                "description": "The maximum value of the apparel price preference (e.g., 300).",
                "type": "number"
              },
              "currency": {
                "description": "The maximum currency of the apparel price preference (e.g., usd).",
                "type": "string",
                "enum": [
                  "usd"
                ]
              }
            }
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "apparelPricePreferences": [
    {
      "department": "mens",
      "category": "shoes",
      "minResponse": {
        "amount": 15,
        "currency": "usd"
      },
      "maxResponse": {
        "amount": 300,
        "currency": "usd"
      }
    }
  ]
}

Shopping preferences - bulk shopping

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
intents The intent to shop in bulk. bulk

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Bulk Shopping",
  "description": "Includes the intent to shop in bulk configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "required": [
    "eventDate",
    "intents"
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "intents": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "maxItems": 1,
      "description": "The intent to shop in bulk (e.g., bulk).",
      "items": {
        "type": "string",
        "enum": [
          "bulk"
        ]
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "intents": [
    "bulk"
  ]
}

Shopping preferences - sustainability

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
sustainabilityLabelPreferences The climate pledge friendly preferences. N/A
sustainabilityLabelPreferences.label The label of the sustainability label preference. carbon-impact
sustainabilityLabelPreferences.preference The preference of the sustainability label preference. yes
sustainabilitySearchPreference The climate pledge friendly search preference. yes

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Sustainability",
  "description": "Includes the sustainability shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "anyOf": [
    {
      "required": [
        "sustainabilityLabelPreferences",
        "eventDate"
      ]
    },
    {
      "required": [
        "sustainabilitySearchPreference",
        "eventDate"
      ]
    }
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "sustainabilityLabelPreferences": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The climate pledge friendly preferences.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "label",
          "preference"
        ],
        "properties": {
          "label": {
            "description": "The label of the sustainability label preference (e.g., carbon-impact).",
            "type": "string",
            "enum": [
              "carbon-impact",
              "recycled-materials",
              "manufacturing-practices",
              "animal-welfare",
              "energy-efficiency",
              "forestry-practices",
              "safer-chemicals",
              "packaging-efficiency",
              "organic-content",
              "worker-wellbeing",
              "water-and-soil-quality",
              "biodiversity",
              "circularity",
              "water-efficiency",
              "general"
            ]
          },
          "preference": {
            "description": "The preference of the sustainability label preference (e.g., yes).",
            "type": "string",
            "enum": [
              "yes",
              "no",
              "No_Response"
            ]
          }
        }
      }
    },
    "sustainabilitySearchPreference": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The climate pledge friendly search preference (e.g., yes).",
      "items": {
        "type": "string",
        "enum": [
          "yes",
          "no",
          "No_Response"
        ]
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "sustainabilityLabelPreferences": [
    {
      "label": "carbon-impact",
      "preference": "yes"
    }
  ],
  "sustainabilitySearchPreference": [
    "yes"
  ]
}

Shopping preferences - clothing fit

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
shoulders The shoulder fit preference. average
chest The chest fit preference. narrow
waist The waist fit preference. average
hips The hips fit preference. wide
thighs The thighs fit preference. average

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Clothing Fit",
  "description": "Includes the clothing fit shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "anyOf": [
    {
      "required": [
        "shoulders",
        "eventDate"
      ]
    },
    {
      "required": [
        "chest",
        "eventDate"
      ]
    },
    {
      "required": [
        "waist",
        "eventDate"
      ]
    },
    {
      "required": [
        "hips",
        "eventDate"
      ]
    },
    {
      "required": [
        "thighs",
        "eventDate"
      ]
    }
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "shoulders": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1,
      "description": "The shoulder fit preference (e.g., average).",
      "items": {
        "type": "string",
        "enum": [
          "average",
          "narrow",
          "wide",
          "No_Response"
        ]
      }
    },
    "chest": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1,
      "description": "The chest fit preference (e.g., narrow).",
      "items": {
        "type": "string",
        "enum": [
          "average",
          "narrow",
          "wide",
          "No_Response"
        ]
      }
    },
    "waist": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1,
      "description": "The waist fit preference (e.g., average).",
      "items": {
        "type": "string",
        "enum": [
          "average",
          "narrow",
          "wide",
          "No_Response"
        ]
      }
    },
    "hips": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1,
      "description": "The hips fit preference (e.g., wide).",
      "items": {
        "type": "string",
        "enum": [
          "average",
          "narrow",
          "wide",
          "No_Response"
        ]
      }
    },
    "thighs": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1,
      "description": "The thighs fit preference (e.g., average).",
      "items": {
        "type": "string",
        "enum": [
          "average",
          "narrow",
          "wide",
          "No_Response"
        ]
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "shoulders": [
    "average"
  ],
  "chest": [
    "narrow"
  ],
  "waist": [
    "average"
  ],
  "hips": [
    "wide"
  ],
  "thighs": [
    "average"
  ]
}

Shopping preferences - body

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
bodyShape The shape of the body. N/A
bodyShape.department The department of the shape of the body. womens
bodyShape.category The category of the shape of the body. body-shape
bodyShape.response The value of the shape of the body. hourglass
bodyFocus The focus info for different body parts. N/A
bodyFocus.department The department of the body focus. mens
bodyFocus.category The category of the body focus. arms
bodyFocus.response The value of the body focus. hide

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Body",
  "description": "Includes the body shopping preferences configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "anyOf": [
    {
      "required": [
        "bodyShape",
        "eventDate"
      ]
    },
    {
      "required": [
        "bodyFocus",
        "eventDate"
      ]
    }
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "bodyShape": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The shape of the body.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The department of the shape of the body (e.g., womens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the shape of the body (e.g., body-shape).",
            "type": "string",
            "enum": [
              "body-shape"
            ]
          },
          "response": {
            "description": "The value of the shape of the body (e.g., hourglass).",
            "type": "string",
            "enum": [
              "hourglass",
              "invertedtriangle",
              "rectangle",
              "round",
              "triangle",
              "No_Response"
            ]
          }
        }
      }
    },
    "bodyFocus": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The focus info for different body parts.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "department",
          "category",
          "response"
        ],
        "properties": {
          "department": {
            "description": "The department of the body focus (e.g., mens).",
            "type": "string",
            "enum": [
              "mens",
              "womens",
              "No_Response"
            ]
          },
          "category": {
            "description": "The category of the body focus (e.g., arms).",
            "type": "string",
            "enum": [
              "arms",
              "legs",
              "waist",
              "chest",
              "hips",
              "back"
            ]
          },
          "response": {
            "description": "The value of the body focus (e.g., hide).",
            "type": "string",
            "enum": [
              "hide",
              "neutral",
              "highlight",
              "No_Response"
            ]
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "bodyShape": [
    {
      "department": "womens",
      "category": "body-shape",
      "response": "hourglass"
    }
  ],
  "bodyFocus": [
    {
      "department": "mens",
      "category": "arms",
      "response": "hide"
    }
  ]
}

Shopping preferences - customer

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
ageRange The age range of the customer in bands of 5 years. 21-25
socialMediaLinks The social media links. N/A
socialMediaLinks.category The category of the social media link. facebook
socialMediaLinks.response The value of the social media link. https://www.facebook.com/username
requestedADAAccommodations The disability accommodations. N/A
requestedADAAccommodations.category The category of the disability accommodations. fitting-room
requestedADAAccommodations.response The value of the disability accommodations. no

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Shopping Preferences - Customer",
  "description": "Includes the customer preferences profile configured by the customer.",
  "type": "object",
  "unevaluatedProperties": false,
  "anyOf": [
    {
      "required": [
        "ageRange",
        "eventDate"
      ]
    },
    {
      "required": [
        "socialMediaLinks",
        "eventDate"
      ]
    },
    {
      "required": [
        "requestedADAAccommodations",
        "eventDate"
      ]
    }
  ],
  "properties": {
    "marketplace": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
    },
    "ageRange": {
      "type": "array",
      "description": "The age range of the customer in bands of 5 years (e.g., 21-25).",
      "items": {
        "type": "string"
      }
    },
    "socialMediaLinks": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The social media links.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "response"
        ],
        "properties": {
          "category": {
            "description": "The category of the social media link (e.g., facebook).",
            "type": "string",
            "enum": [
              "facebook",
              "pinterest",
              "instagram"
            ]
          },
          "response": {
            "description": "The value of the social media link (e.g., https://www.facebook.com/username).",
            "type": "string",
            "maxLength": 256,
            "pattern": "^(https?://.*$)|(No_Response$)"
          }
        }
      }
    },
    "requestedADAAccommodations": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "description": "The disability accommodations.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "response"
        ],
        "properties": {
          "category": {
            "description": "The category of the disability accommodations (e.g., fitting-room).",
            "type": "string",
            "enum": [
              "fitting-room"
            ]
          },
          "response": {
            "description": "The value of the disability accommodations (e.g., no).",
            "type": "string",
            "enum": [
              "yes",
              "no"
            ]
          }
        }
      }
    }
  }
}

Sample data based on the sample schema:

{
  "marketplace": "DE",
  "eventDate": "2021-09-29T11:04:43.305Z",
  "ageRange": [
    "21-25"
  ],
  "socialMediaLinks": [
    {
      "category": "facebook",
      "response": "https://www.facebook.com/username"
    }
  ],
  "requestedADAAccommodations": [
    {
      "category": "fitting-room",
      "response": "no"
    }
  ]
}

Sports interests

This scope includes Amazon customer's confirmed sports interests and poll responses.

Identifiers:

  • Login with Amazon Scope Name: portability::interests
  • Amazon Data Portability scopeId : portability-interests

Sports interests - poll responses

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
pickAWinnerCustomerResponsesGame The game on which the customer voted. It contains the participants, day, and time of the game. usa-football-arizona-cardinals vs. usa-football-seattle-seahawks | Game Time: 2021-06-08T06:08:00
customerTeamVote The participant for which the customer voted. usa-football-seattle-seahawks
customerResponseTime The time when the customer took the vote action, in the ISO 8601 date-time format and UTC time zone. 2021-09-29T11:04:43.305Z
customerVoteRegion The region where the experience was showed to the customer. Germany

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Sport Interests - Poll Responses",
  "description": "Includes customer's sports interests poll responses.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "pickAWinnerCustomerResponsesGame": {
        "description": "The game on which the customer voted. It contains the participants, day, and time of the game (e.g., usa-football-arizona-cardinals vs. usa-football-seattle-seahawks | Game Time: 2021-06-08T06:08:00).",
        "type": "string"
      },
      "customerTeamVote": {
        "description": "The participant for which the customer voted (e.g., usa-football-seattle-seahawks).",
        "type": "string"
      },
      "customerResponseTime": {
        "description": "The time when the customer took the vote action, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "customerVoteRegion": {
        "description": "The region where the experience was showed to the customer (e.g., Germany).",
        "type": "string"
      },
      "marketplace": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "pickAWinnerCustomerResponsesGame",
      "customerTeamVote",
      "customerResponseTime",
      "marketplace",
      "eventDate"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "pickAWinnerCustomerResponsesGame": "usa-football-arizona-cardinals vs. usa-football-seattle-seahawks | Game Time: 2021-06-08T06:08:00",
    "customerTeamVote": "usa-football-seattle-seahawks",
    "customerResponseTime": "2021-09-29T11:04:43.305Z",
    "customerVoteRegion": "Germany"
  }
]

Sports interests - confirmed interests

Schema properties:

Properties Details Example value
marketplace The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard. DE
eventDate The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ). 2021-09-29T11:04:43.305Z
interestName The name of the interest. fishing
isInterested The flag that specifies the affinity towards the interest. true
lastUpdatedDate The date that the record was last updated by a customer action, in the ISO 8601 date-time format and UTC time zone. 2021-09-29T11:04:43.305Z

Sample schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Sport Interests - Confirmed Interests",
  "description": "Includes customer's confirmed sports interests.",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "interestName": {
        "description": "The name of the interest (e.g., fishing).",
        "type": "string"
      },
      "isInterested": {
        "description": "The flag that specifies the affinity towards the interest (e.g., true).",
        "type": "boolean"
      },
      "lastUpdatedDate": {
        "description": "The date that the record was last updated by a customer action, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z).",
        "type": "string",
        "format": "date-time"
      },
      "marketplace": {
        "type": "string",
        "pattern": "^[A-Z]{2}$",
        "description": "The marketplace where the record was generated, formatted according to ISO 3166-1 alpha-2 standard (e.g., DE)."
      },
      "eventDate": {
        "type": "string",
        "format": "date-time",
        "description": "The date when the record was generated, in the ISO 8601 date-time format and UTC time zone (e.g., YYYY-MM-DDThh:mm:ss.sssZ - 2021-09-29T11:04:43.305Z)."
      }
    },
    "unevaluatedProperties": false,
    "required": [
      "interestName",
      "isInterested",
      "lastUpdatedDate",
      "marketplace",
      "eventDate"
    ]
  }
}

Sample data based on the sample schema:

[
  {
    "marketplace": "DE",
    "eventDate": "2021-09-29T11:04:43.305Z",
    "interestName": "fishing",
    "isInterested": true,
    "lastUpdatedDate": "2021-09-29T11:04:43.305Z"
  }
]

Last updated: Aug 12, 2024