Retrieve your profile information
Retrieves full statistics and profile information for the authenticated user.
URL: | https://api.trademe.co.nz/v1/MyTradeMe/Summary.{file_format} |
---|---|
HTTP Method: | GET |
Requires Authentication? | Yes |
Permission Required: | MyTradeMeRead: Read your membership & listing data. |
Supported Formats: | XML, JSON |
Rate Limited? | Yes |
URL parameters
file_format | Enumeration (required) | The format of the response. | ||||
---|---|---|---|---|---|---|
|
Query String parameters
return_member_profile | Boolean (optional) |
If true, also returns the member's public profile information (occupation, bio, photo, etc). |
---|
Returns
<MemberSummary>
The user's name, email address, bought, sold and feedback stats.
WatchListCount | Integer |
The number of items on the watchlist. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
WonCount | Integer |
The number of items won. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LostCount | Integer |
The number of items lost. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SellingCount | Integer |
The number of items being sold. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SoldCount | Integer |
The number of items sold. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UnsoldCount | Integer |
The number of items unsold. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PositiveFeedback | Integer |
The total positive feedback. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NegativeFeedback | Integer |
The total negative feedback. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TotalFeedback | Integer |
The total feedback (positive - negative). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MemberId | Integer |
The ID of the member. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nickname | String or null |
The member's nickname. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DateJoined | DateTime |
The date the member registered for an account on Trade Me. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DateAddressVerified | DateTime |
The date and time the member became address verified, if they are address verified. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsAddressVerified | Boolean |
Indicates whether the member is address verified. This means the member entered a code that was delivered via the postal system to the member's street address. Note that currently, members retain their address verified status if they move, so having this status doesn't necessarily mean that the member's current address is valid. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Balance | Number |
The member's Trade Me account balance. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PayNowBalance | Number |
The member's Pay Now account balance. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FirstName | String or null |
The member's first name. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LastName | String or null |
The member's last name. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FixedPriceOffers | Integer |
The number of fixed price offers for the member. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
String or null |
The email address for the member. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Gender | Enumeration |
The gender of the member. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MembershipAddress | <DeliveryAddress> or null |
The member's primary address. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsBusiness | Boolean |
Indicates whether the member has registered as a business. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BusinessName | String or null |
The member's business name (business memberships only). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BillingAddress | <DeliveryAddress> or null |
The member's billing address (business memberships only). This is optional even for business memberships. If it doesn't exist, assume the billing address is the same as the delivery address. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
(This type has already been defined) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ClosestLocality | String or null |
The name of the closest locality to the member. Based on the "Closest town" information supplied by the member when creating their account. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ClosestDistrict | String or null |
The name of the closest district to the member. Based on the "Closest town" information supplied by the member when creating their account. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ClosestDistrictId | Integer |
The ID of the closest district to the member. Based on the "Closest town" information supplied by the member when creating their account. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsAuthenticated | Boolean |
Indicates whether the member is authenticated. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsPayNowAccepted | Boolean |
Indicates whether the member can accept Pay Now payments. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FavouriteSearchCount | Integer |
The number of saved searches in the member's favourites. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FavouriteCategoryCount | Integer |
The number of saved categories in the member's favourites. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FavouriteSellerCount | Integer |
The number of saved sellers in the member's favourites. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AutoBillingEnabled | Boolean |
Indicates whether the member has set up auto-billing. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CanListClearanceItems | Boolean |
Indicates whether the member can list clearance items using the IsClearance flag. This is currently only for certain elite sellers. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsTopSeller | Boolean |
Indicates whether the member is currently a registered top seller. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsRegisteredWineSeller | Boolean |
Indicates whether the member is currently a registered wine seller. This will be false if the member has not registered, or if the registration has been disabled, or if the off-license has expired, or if the member cannot accept Pay Now payments. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsPropertyAgent | Boolean |
Indicates whether the member is registered as a property agent. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsRentalAgent | Boolean |
Indicates whether the member is registered as a rental agent. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsJobAgent | Boolean |
Indicates whether the member is registered as a job agent. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CreditCardType | String or null |
If the user has a saved credit card that they can use, contains the card type ("Visa", "MasterCard", etc). Will be omitted if the user does not have a saved card. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CreditCardLastFourDigits | String or null |
If the user has a saved credit card, contains the last four digits of the card number (e.g. "1234"). Will be omitted if the user does not have a saved card. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CreditCardExpiryMonth | Integer |
If the user has a saved credit card, contains the month when it expires (1 = January, 12 = December). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CreditCardExpiryYear | Integer |
If the user has a saved credit card, contains the year when it expires. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RecentSearchesEnabled | Boolean |
Indicates whether recent searches are recorded against the user's profile. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HighVolumeListingCount | Integer |
The number of active listings the member has which contribute towards the high volume threshold. Generally speaking, auctions contribute towards the high volume threshold while classifieds do not. Some categories are exempt; listings within those categories do not count towards the threshold either. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HighVolumeThreshold | Integer |
The user's high volume listing allowance. This is the number of active listings you can have without incurring a high volume listing fee (this fee is charged for each new listing). All classifieds and auctions in some categories are exempt from high volume listing fees. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CanRemoveBids | Boolean |
Indicates whether the member can remove bids using the remove bid API. This field will always return true. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ShoppingCartCount | Integer |
The number of items in the members cart. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsInTrade | Boolean |
Indicates whether the member is a professional trader. If they are a professional trader then their listings are protected by the Consumer Guarantees Act. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MemberProfile | <SimpleMemberProfile> or null |
This member's public profile information. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ExternalTrackingToken | String or null |
An external tracking token used to uniquely identify a member without exposing member information. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LandlinePhoneNumber | String or null |
The member's landline phone number. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MobilePhoneNumber | String or null |
The member's mobile phone number. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MemberToken | String or null |
The members token |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TradevineAccountType | Enumeration |
The member's Tradevine account type (Tradevine, MyProducts or neither) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DraftSummary | <DraftSummary> or null |
The number of items lost. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JobProfiles | Collection of <JobProfileSummary> or null |
The member's job profiles |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AvailableExternalPaymentProviders | Collection of Enumeration or null |
List of deferred payments the member can use |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MemberTokens | Collection of <MemberToken> or null |
The collection of member tokens a member has for external services |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LoyaltySubscriptionDetails | <MemberLoyaltySubscriptionDetails> or null |
The member's loyalty subscription details. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TaxLiabilities | Collection of <TaxRate> or null |
The taxes that Trade Me will collect automatically on behalf of this member when they sell on Trade Me |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Location | <MapPoint> or null |
Longitude and Latitude of member's location. For now it's based on the "Closest town" information supplied by the member when creating their account. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PayNowStatus | Enumeration |
The status of the member's pay now account. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SegmentUserId | String or null |
The member's Segment user ID. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IsBasic | Boolean |
Indicates the member has only registered with a small portion of information |