Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Category-1 Scopes

To gain access to Category-1 scopes, you will complete the Identity Verification and the Business Offering & Privacy Review 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"
  }
]

Last updated: Nov 10, 2026