eBay Shopping APIVersion 1085

SimpleUserType

Complex type used to express the details for one eBay user. Which fields are returned in a call response will depend on the context, the API call, and whether the user is a buyer or seller (or both).

Types that use SimpleUserType:

Calls that use SimpleUserType:

Fields



AboutMeURL ( anyURI ) [0..1]
The URL to the eBay About Me page. Only returned if one exists for the eBay user.
See the Field Index to learn which calls use AboutMeURL.

FeedbackDetailsURL ( anyURI ) [0..1]
The URL to the eBay user's Feedback Profile page, which has full details of the eBay user's Feedback History, including Feedback Ratings, Feedback Comments, and Detailed Seller Ratings.
See the Field Index to learn which calls use FeedbackDetailsURL.

FeedbackPrivate ( boolean ) [0..1]
This boolean value indicates whether or not the eBay user has chosen to make their Feedback Profile private in My eBay. A private Feedback Profile only means that individual Feedback comments are hidden, but other Feedback statistics will still be displayed, including the total Feedback score and the Positive Feedback Percentage.

Sellers on eBay marketplaces do not have the option of making their Feedback Profile private, and they will be blocked from listing if they try to list items with a private Feedback Profile.
See the Field Index to learn which calls use FeedbackPrivate.

FeedbackRatingStar ( FeedbackRatingStarCodeType ) [0..1]
This enumeration value indicates the eBay user's Feedback Rating Star. A different colored star is associated with each Feedback Score range. For more details on the Feedback Score ranges (and colored stars associated with each range), see FeedbackRatingStarCodeType.
See the Field Index to learn which calls use FeedbackRatingStar.

FeedbackScore ( int ) [0..1]
The aggregate Feedback score of an eBay user. A user's Feedback score is determined by the total number of Positive Feedback ratings minus the total number of Negative Feedback ratings the user has received. Any Neutral Feedback ratings do not affect the Feedback Score.

A user's Feedback Score is a quantitative expression of the desirability of dealing with that user as a buyer or a seller. A buyer can leave Positive, Neutral, or Negative Feedback for the seller, but a seller can only leave Positive Feedback for the buyer.
See the Field Index to learn which calls use FeedbackScore.

MyWorldLargeImage ( anyURI ) [0..1]
The URL to the large version of the eBay user's profile image/logo. This field is only returned if available.
See the Field Index to learn which calls use MyWorldLargeImage.

MyWorldSmallImage ( anyURI ) [0..1]
The URL to the small version of the eBay user's profile image/logo. This field is only returned if available.
See the Field Index to learn which calls use MyWorldSmallImage.

MyWorldURL ( anyURI ) [0..1]
The URL to the eBay user's home page (formerly called 'My World'). The home page shows Feedback statistics and has multiple links, such as a link to the seller's eBay Store and a link to the seller's other items.
See the Field Index to learn which calls use MyWorldURL.

NewUser ( boolean ) [0..1]
If 'true', identifies a new user who has been a registered eBay user for 30 days or less. Always 'false' after the user has been registered for more than 30 days.
See the Field Index to learn which calls use NewUser.

PositiveFeedbackPercent ( float ) [0..1]
This value is the percentage value of a seller's Feedback entries that were marked by buyer's as 'Positive'. This number is calculated by dividing the total number of Feedback entries left for the seller (Positive, Neutral, and Negative) by only the seller's 'Positive' Feedback ratings.
See the Field Index to learn which calls use PositiveFeedbackPercent.

RegistrationDate ( dateTime ) [0..1]
This timestamp indicates when the user originally registered with eBay. If a bidder's user information is made anonymous, the value -99 is returned.
See the Field Index to learn which calls use RegistrationDate.

RegistrationSite ( SiteCodeType ) [0..1]
The enumeration value returned in this field indicates the eBay site on which the user first created an eBay account. If a bidder's user information is made anonymous, the value -99 is returned.
See the Field Index to learn which calls use RegistrationSite.

ReviewsAndGuidesURL ( anyURI ) [0..1]
The URL to a page where it shows any product reviews/ratings that have been given by the eBay user.
See the Field Index to learn which calls use ReviewsAndGuidesURL.

SellerBusinessType ( SellerBusinessCodeType ) [0..1]
This enumeration value indicates the type of seller account held by the eBay user - a Private (non-business) account or a Commercial (business) account.
See the Field Index to learn which calls use SellerBusinessType.

SellerItemsURL ( anyURI ) [0..1]
The URL for an eBay marketplace page that displays a list of the seller's active listings.
See the Field Index to learn which calls use SellerItemsURL.

SellerLevel ( SellerLevelCodeType ) [0..1]
The enumerated value in this field indicates the current Power Seller level of the eBay user. There are five Power Seller tiers, and each tier is based on average monthly sales. Available benefits and services to the seller vary for each tier.

This field is only returned if the eBay user is a Power Seller, and is not returned at all on some eBay marketplaces.
See the Field Index to learn which calls use SellerLevel.

The enumeration value returned in this field indicates the current status of the eBay user. A value of Confirmed is typically returned for an active eBay user.
See the Field Index to learn which calls use Status.

StoreName ( string ) [0..1]
The name of the seller's eBay Store. This field is only applicable to eBay sellers that have eBay Store subscriptions.
See the Field Index to learn which calls use StoreName.

StoreURL ( anyURI ) [0..1]
The URL of the seller's eBay Store page. This field is only applicable to eBay sellers that have eBay Store subscriptions.
See the Field Index to learn which calls use StoreURL.

TopRatedSeller ( boolean ) [0..1]
This boolean field is only returned if true, and indicates if the eBay user has Top-Rated Seller status. Top-Rated sellers are eligible to get the 'Top-Rated Plus' badge on all of their active listings (meeting Top-Rated Plus requirements), and qualify for other benefits such as Final Value Fee discounts and increased visibility in search results.
See the Field Index to learn which calls use TopRatedSeller.

UserAnonymized ( boolean ) [0..1]
Indicates whether eBay has made this user's information anonymous.

If true, certain other fields about this user are not returned, or their values are masked.
See the Field Index to learn which calls use UserAnonymized.

UserID ( string ) [0..1]
The unique identifier of the eBay user. An eBay user ID is unique across all eBay marketplaces.

This field is generally always returned, but it may be masked depending on the situation. For example, if anyone other than the seller of the listing runs a GetItemStatus call on an active auction listing with one or or bids, the UserID value will be masked something like this - b***r.
See the Field Index to learn which calls use UserID.