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

