Website logo

Retrieve the details of a single listing

Retrieves the details of a single listing, in a format suitable for editing. This API only works if you are the seller of the listing.

URL: https://api.trademe.co.nz/v1/Selling/Listings/{listingId}.{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

listingId Integer (required)

The ID of the listing.

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Returns

<EditListingRequest>

Category String or null

The ID of the category to list the item in. For example, specify "6853" to list an oil heater. This field also accepts the MCAT category format (e.g. "0004-0370-0560-6853-"). Ignored when listing from the DVD/Blu-ray catalogue.

Title String or null

The title of the listing. Maximum of 80 characters for Marketplace categories, 50 for the other businesses. Mandatory for most categories. In some categories (e.g. used cars, motorbikes, flatmates wanted) the title is based on one or more attributes. In these categories the title is optional, and is ignored if it is supplied. Not required when listing from the DVD/Blu-ray catalogue.

Subtitle String or null

The subtitle of the listing. Optional. Maximum of 50 characters.

Description Collection of String or null

A plain text description of the listing. Use CRLF to insert a new line. Mandatory for all auction types except DVD and Blu-ray catalogue listings. Maximum length of 5100 characters for job listings and 2048 characters for all others.

StartPrice Number

The start price of the listing. Mandatory for auctions. Must be a minimum of 50c and must be less than or equal to the ReservePrice. For most classifieds this value is optional: if specified it is the value that is displayed as the ‘Asking price’. A notable exception to this rule are business for sale classifieds. Not used for property listings (subcategories of category 350); use the PropertyPricePrice attribute instead.

ReservePrice Number

The reserve price of the listing. Optional. If supplied, it must be a minimum of 50c and it must be greater than or equal to the StartPrice. Only applicable to auctions, ignored for classifieds.

BuyNowPrice Number

The Buy Now price of the listing. Optional. Must be a minimum of 50c, must be greater than or equal to the StartPrice. For Buy Now Only auctions quantity and shipping information must be specified. See Quantity and IsFlatShippingCharge. Only applicable to auctions, ignored for classifieds.

Duration Enumeration

The duration of the listing. Mandatory. Must be one of the durations available as per the category details API. Can be a fixed duration or a specified end time.

EndDate 0

An end date will be used to set the duration.

Two 2

Two days.

Three 3

Three days.

Four 4

Four days.

Five 5

Five days.

Six 6

Six days.

Seven 7

A week.

Ten 10

Ten days.

Fourteen 14

14 days.

TwentyOne 21

21 days.

TwentyEight 28

28 days.

Thirty 30

30 days.

FortyTwo 42

42 days.

FiftySix 56

56 days.

EightyFour 84

84 days (Commercial for Sale, Commercial for Lease, New Homes only).

Ninety 90

90 days (Retirement Villages only).

HundredSixtyEight 168

168 days (Commercial for Sale, Commercial for Lease only).

UntilWithdrawn -1

until withdrawn (only available for agents outside of the services category)

EndDateTime DateTime

The date and time the listing should close. Ignored unless Duration is set to EndDate.

Pickup Enumeration

Indicates whether the buyer can (or is required to) pick-up the item. For auctions any value other than Demand implies that at least one shipping option must be provided. For classifieds this value is ignored.

None 0

The listing allows pick up, but does not require it.

Allow 1

The buyer can pickup if they so choose.

Demand 2

The buyer must pickup the item.

Forbid 3

The buyer cannot pickup the item (delivery only).

PickupSuburbId Integer or null

If the buyer can (or is required to) pick-up the item then this field can be used to specify the pick-up suburb id. It uses the three-tier region/district/suburb system. Optional. Only applicable to auctions, ignored for classifieds.

IsBrandNew Boolean

Indicates whether the listing is for a brand new item. Optional, defaults to false. Only applicable to auctions, ignored for classifieds.

AuthenticatedMembersOnly Boolean or null

Determines if only authenticated members can bid on the listing. Only applicable to auctions, ignored for classifieds.

IsClassified Boolean

Determines if this listing is a classified or an auction. Optional, defaults to false. Some categories support auctions, some support classifieds and some accept both types. Use the category details API to check which types a category supports.

OpenHomes Collection of <OpenHome> or null

A list of upcoming open home times. Currently only applies to residential for sale (category 3399) and lifestyle (category 9120) listings.

Start DateTime

The date and time the open home is open for viewing. The date must be in the future and it must be less than 56 days from the current date. Specify dates in the UTC time zone.

End DateTime

The date and time the open home is no longer open for viewing. Must be the same day as Start.

SendPaymentInstructions Boolean

Determines if only the payment instructions are sent at the end of the listing Specifies if automatic payment instructions email will be sent to the winner of the auction. Optional, defaults to false.

OtherPaymentMethod String or null

If the list of payment methods includes Other then this field can be used to specify the name of the payment method. Optional. Only applicable to auctions that have the Other payment method.

IsOrNearOffer Boolean

Specifies if ‘ONO’ should be displayed with price on listing. Optional. Applicable only to classified listings.

IsPriceOnApplication Boolean

Specifies that the price should be displayed as "Price on Application". Optional. Applicable only to businesses for sale listings (subcategories of category 36).

IsBold Boolean

Applies the bold promotion onto the listing. Only permitted in categories that support bold. Whether or not it’s available in a category can be confirmed using the Fees API endpoint. Note that a discount may be applicable if all the feature combo promotions are specified (feature, bold, highlight and gallery). Also note that promotions cannot be removed from a listing.

IsFeatured Boolean

Applies the feature promotion onto the listing. Only permitted in categories that support this promotion. Whether or not it’s available in a category can be confirmed using the Fees API endpoint. Note that a discount may be applicable if all the feature combo promotions are specified (feature, bold, highlight and gallery). Also note that promotions cannot be removed from a listing.

IsHomepageFeatured Boolean

*deprecated*

HasGallery Boolean

Applies the gallery promotion onto the listing. Only permitted in categories that support this promotion. Whether or not it’s available in a category can be confirmed using the Fees API endpoint. Note that a discount may be applicable if all the feature combo promotions are specified (feature, bold, highlight and gallery). Also note that promotions cannot be removed from a listing.

HasGalleryPlus Boolean

Applies the gallery plus promotion onto the listing. Only permitted in categories that support this promotion. Whether or not it’s available in a category can be confirmed using the Fees API endpoint. This promotion cannot be applied to a listing that already has the gallery promotion. Note that promotions cannot be removed from a listing.

Quantity Integer or null

For Buy Now Only auctions this is the quantity of items that are available for sale. Optional. Can be between 1 and 1000. Setting the quantity (even to 1) will prevent bidding and make a listing only purchasable via Buy Now. Note that when editing, the value must be less than or equal to 1000 - (quantity sold). The quantity sold for a listing can be calculated by adding up all the QuantitySold values from the listing details response.

IsFlatShippingCharge Boolean or null

For Buy Now Only auctions this specifies if the shipping is one rate for multiple quantities. If false is specified the winning bidder will be charged the shipping rate multiplied by the quantity of items purchased. If true is specified one flat shipping rate is charged. Only applicable for auctions, ignored for classifieds.

HasAgreedWithLegalNotice Boolean

Specifies if the user has read and agreed with the legal notice relevant to the category the listing is being created in. The category details API can be used to retrieve the legal notice for a specific category (only applies to certain categories, such as the category 6327 - Carbon Credits).

HomePhoneNumber String or null

Home phone number to be displayed on listing. Optional. Only applicable in categories where the user has paid a listing fee. Must be 9 digits long and use a valid area code. Can be specified but will only be displayed when category permits.

MobilePhoneNumber String or null

Mobile phone number to be displayed on listing. Optional. Only applicable in categories where the user has paid a listing fee. Must be 8 or 9 digits long. Can be specified but will only be displayed when category permits.

IsHighlighted Boolean

Applies the “highlight” promotion onto the listing. Only permitted in categories that support this promotion. Whether or not it’s available in a category can be confirmed using the Fees API endpoint. Note that a discount may be applicable if all the feature combo promotions are specified (feature, bold, highlight and gallery). Also note that promotions cannot be removed from a listing.

HasSuperFeature Boolean

Applies the “super feature” promotion onto the listing. Only permitted in categories that support this promotion. Whether or not it’s available in a category can be confirmed using the Fees API endpoint. Note that when creating a new listing with the super feature promotion, the feature, bold, highlight and gallery promotions will automatically be applied. Also note that promotions cannot be removed from a listing.

PhotoIds Collection of Integer or null

Photo IDs for images that have already been uploaded that you want to display on the listing. For all general items categories all photos are free (up to 20 max). Check the category details API for exact details. Note that photos may be deleted if they are unused for too long. It is up to you to ensure that your photo IDs are valid. See our photo retention policy for more information.

ShippingOptions Collection of <ShippingOption> or null

The shipping options to be displayed on the listing. Can contain up to ten shipping options. Mandatory for auctions, ignored for classifieds.

Type Enumeration

The type of delivery.

None 0

The type of the "None of the options apply to me" shipping option. Do not use when listing an item.

Unknown 0

Obsolete. Do not use.

Undecided 1

Indicates that the seller will confirm the shipping details with the buyer directly. This shipping option cannot be used when Pay Now is specified as a payment option. When listing an item, this option cannot be used in combination with other shipping options.

Pickup 2

Indicates the item can be picked up. Do not use when listing an item (use the Pickup field instead).

Free 3

Indicates the item can be shipped for free within New Zealand. When listing an item, this option cannot be used in combination with other shipping options.

Custom 4

Custom shipping option. Allows the seller to specify the price and description. Multiple custom shipping options are allowed (up to ten).

TradeMe 5

Trademe shipping option. Allows the seller to calculate the quotes from couriers, all calculated quotes will be saved in custom shipping options.

Price Number

The price of the delivery option. Only applicable if ShippingType is Custom. Rounded up to the nearest 2 decimal places.

Method String or null

The name of the delivery method (e.g. "NZ Courier", "Rural Delivery"). Only applicable if ShippingType is Custom.

PaymentMethods Collection of Enumeration or null

The acceptable payment methods to be displayed on the listing. Mandatory for auctions, ignored for classifieds.

None 0

No payment methods provided.

BankDeposit 1

NZ bank deposit.

CreditCard 2

Credit card. (Processed via Pay Now if the seller uses Pay Now, otherwise Buy Now)

Cash 4

Cash.

SafeTrader 8

Safe Trader (Now obsolete).

Other 16

Other (needs to be specified).

Ping 32

Ping.

Afterpay 64

Afterpay.

Attributes Collection of <Attribute> or null

The attribute values for a listing. The attributes for a category can be found using the category details API. Additionally, some API clients may supply any number of dynamic attributes i.e. name-value pairs as defined by the client Some well-known attribute names will also help users find your listings: Google Shopping Feed We include attributes that are named and correctly formatted in a feed that goes to Google Shopping. These are on the ProductSpecification section so include this data if you have it.

Name String or null

A name which uniquely identifies the attribute. Required when selling or editing.

Value String or null

The string value of the attribute. When listing, the valid values for the attribute can be determined using the "Retrieve attributes for a category" API. Use "false" or "true" for boolean attributes. Required when selling or editing.

Unit String or null

The selected unit. Only applicable to attributes that have at least one associated unit. This field is optional, but if supplied, will be saved along with the value. The list of valid units can be retrieved from the category details API.

IsClearance Boolean

Indicates that the listing is a clearance item. Only applicable on auctions for members who have a Trade Me store. Ignored for classifieds.

ExternalReferenceId String or null

Allows the API client to associate an identifier (or any short string) against the listing. This value can be searched on but is otherwise only accessible via the API. Not used by Trade Me. Optional. Max 50 characters.

Contacts Collection of <Contact> or null

A list of contact details. Optional. Currently only applicable for property categories and property agents that have billing methods covering the type of category. For example to add contact details in the residential for rent category the agent must have residential for rent billing enabled.

FullName String or null

The full name of the contact person or agent. Mandatory.

PhoneNumber String or null

The primary phone number of the contact. Can be either a mobile or landline number. Optional.

AlternatePhoneNumber String or null

The secondary phone number of the contact. Can be either a mobile or landline number. Optional.

EMail String or null

The email address of the contact to be used for email enquiries. Optional.

BrandingImageId Integer

The ID of the branding image to display an agent photo on this listing. See the upload branding image API. Optional.

DonationRecipient Enumeration or null

Indicates the user would like to round up their success fees to the nearest dollar and donate the difference to the selected charity.

None 0

The default charity identifier. Used if the user chose not to donate to a charity at all.

ForestAndBird 1

Donate to Forest and Bird's kiwis for kiwis program.

Plunket 2

Donate to Plunket.

StJohn 3

Donate to St John.

OurPeopleOurCityFund 4

Donate to Our People, Our City Fund.

CatalogueId String or null

Used for listing catalogue items and is the catalogue ID of the DVD or Blu-ray that is being listed. There is a separate API for finding the catalogue ID using the name of the movie. Catalogue items (category 9232 or category 365) can change their catalogue id but cannot be changed from a catalogue listing to a non-catalogue listing.

RemainingGalleryPlusRelists Integer or null

The number of times the item can be relisted and get the gallery promotion for free. Ignored when creating or editing a listing.

PromotionId Integer

Indicates the promotion to apply to this listing. This ID can be retrieved using the category details API. When editing, promotions can only be upgraded, they cannot be downgraded.

ExcludeFromShippingPromotion Boolean

Exclude this listing from participating in the sellers shipping promotions.

SKU String or null

SKU or Stock Keeping Unit. Used to uniquely identify an auction's product line. Maximum of 50 characters.

AvailablePromotions Collection of <Promotion> or null

The list of available promotional options for this listing. Only one promotional option can be selected. These are only available in categories where Super Grid has been enabled.

Id Integer

The unique identifier of the promotion.

Name String or null

The name of the promotion.

Description String or null

A short description of the promotion.

Price Number

The current price of the promotion. This price should include any discounts currently applied.

OriginalPrice Number

The price of the promotion before any discounts have been applied.

Recommended Boolean

Whether this promotion is currently being recommended.

MinimumPhotoCount Integer

The minimum number of photos required for the promotion.

DiscountDescription String or null

A short description of any discount applied to this promotion.

DiscountStartDate String or null

The start date of any discount applied to this promotion.

DiscountEndDate String or null

The end date of any discount applied to this promotion.

DiscountDisclaimer String or null

The legal disclaimer of any discount applied to this promotion.

GoodFor2RelistsFee Number

The value of the GoodFor2Relists fee if eligible for this promotion.

ImmutableFields Collection of String or null

A collection of the names of various fields and attributes which cannot be changed under various conditions e.g. a bid has been placed on an Auction, or 7 days has passed after a classified was created.

WasPrice Number or null

The usual price that a product is sold at, or the price before it was marked down. This is always more than the Buy Now price for Auctions, or more than the asking price for Classifieds.

EmbeddedContent <EmbeddedContent> or null

The content keys that are embedded in the listing page (e.g. YouTube Video Key).Use the category details API to check which content types a category supports.

YouTubeVideoKey String or null

The YouTube video key for the listing.

MatterportKey String or null

The Matterport video key for the listing's InsideView content.

IStagingKey String or null

The IStaging video key for the listing's InsideView content.

VimeoVideoKey String or null

The Vimeo video key for the listing.

DiakritFurnishKey String or null

The Diakrit Furnish key for the listing.

DiakritStylerKey String or null

The Diakrit Styler key for the listing.

DiakritPanoramaKey String or null

The Diakrit Panorama key for the listing.

VirtualToursCreatorKey String or null

The Virtual Tours Creator key for the listing.

IsBranded Boolean

A flag indicating the listing should be branded. Only applicable to the Jobs category.

ShortDescription String or null

Summary of the listing. Mandatory for Job listings Maximum of 150 characters.

AdditionalData <AdditionalData> or null

Structured information for Listing Additional Data. Currently only used by featured Job listings.

BulletPoints Collection of String or null

The bullet points for display in the search results

Tags Collection of <Tag> or null

The tags for display in the search results

Name String or null

The name of the tag

VariantDefinition <VariantDefinition> or null

When specified, turns the listing request into a multi-variant listing that creates several child listings. The variants definition is used to describe the variant options that are available and the combinations of variants that make up the multi-variant listing.

OptionSets Collection of <OptionSet> or null

A collection of variant options.

Name String or null

The name used to identify the group of option values, e.g. "size" or "colour".

Values Collection of String or null

The choices available for this option set, e.g. "red", "blue". The sequence in which values are supplied is reflected in the sequence of user-interface elements on listings.

Variants Collection of <Variant> or null

A collection of variants.

SKU String or null

SKU or Stock Keeping Unit. Used to uniquely identify an auction's product line. Maximum of 50 characters.

Price Number

The Buy Now price of the variant. Must be a minimum of 50c.

IsClearance Boolean

This indicates that the listing is a clearance item. Clearance listings include listings with was/now pricing and general clearance stock.

WasPrice Number or null

The Was price of the variant. Must be a minimum of 50c.

Quantity Integer

This is the quantity of items that are available for sale. Can be between 1 and 1000. Note that when editing, the value must be less than or equal to 1000 - (quantity sold). The quantity sold for a listing can be calculated by adding up all the QuantitySold values from the listing details response.

Photos Collection of <Photo> or null

A collection of photo URLs for the listing. Ignored when creating or editing a listing.

Key Integer
Value <PhotoUrl> or null
Thumbnail String or null

The URL for the thumbnail sized photo (always 85x64, with white borders).

List String or null

The URL for the list view sized photo (scaled down to fit 160x120).

Medium String or null

The URL for the medium sized photo (scaled down to fit 175x175).

Gallery String or null

The URL for the gallery sized photo (scaled down to fit 233x176).

Large String or null

The URL for the large sized photo (scaled down to fit 352x264).

FullSize String or null

The URL for the full sized photo (scaled down to fit 670x502).

PlusSize String or null

The URL for the plus sized photo (scaled down to fit).

PhotoId Integer

The ID of the photo.

Options Collection of <Option> or null

The combination of variant options that this variant represents.

Name String or null

The name used to identify the group of option values, e.g. "size" or "colour". This name must match an entry in the option set collection.

Value String or null

The choice that this variant has for the option, e.g. "red", "blue". This name must match an entry in the option set.

Attributes Collection of <Attribute> or null

A collection of dynamic attributes that relate to this variant specifically. These can be any number of name-value pairs. Some well-known attribute names will also help users find your listings: Google Shopping Feed We include attributes that are named and correctly formatted in a feed that goes to Google Shopping. These are Brand, GTIN and Manufacturer Code so include this data if you have it.

(This type has already been defined)
ListingId Long Integer or null

The identifier of the listing that this variant represents.

ProductSpecification <ProductSpecification> or null

The specifications of the product if the variant relates to a product

GTIN String or null

The GTIN of the product e.g. 027242896505

Brand String or null

The brand name of the product e.g. Sony

ManufacturerCode String or null

The product code used by the manufacturer e.g. KDL32W600D

SecondCategory String or null

The ID of the second category to list the item in. For example, specify "6853" to list an oil heater. This field also accepts the MCAT category format (e.g. "0004-0370-0560-6853-"). Not all categories can be used as a second category and not all primary categories can be paired with a second category.

PremiumPackageCode String or null

The code of the premium package to apply to the listing. This will be null if a package is not applied to the listing or a package was previously applied but has since completed.

ProductSpecification <ProductSpecification> or null

The specifications of the product if the listing relates to a product. If this is a multi-variant product, specify these in the Variants section.

(This type has already been defined)
ListingExtrasLedger Collection of <ListingExtras> or null

A collection of extras that have been applied to the listing. This is an output field. We will provide Id, Name, Variant, StartDate, & EndDate. Any changes to this collection is ignored when creating or editing a listing.

(This type has already been defined)
HasGoodFor2Relists Boolean

Indicates if Good For 2 Relists is included with the premium package.

IsOffersAllowed Boolean or null

Indicates if Make an Offer is enabled or not. true is enabled, false is disabled and null means it hasn't set yet.

IsCounterOffersAllowed Boolean or null

Indicates whether the listing is enabled for Counter Offers.

MaximumOffers Integer or null

The maximum number of Buyer offers the listing accepts if the listing has Counter Offers enabled.

Photos Collection of <Photo> or null

A collection of photo URLs for the listing. Ignored when creating or editing a listing.

Key Integer
Value <PhotoUrl> or null
(This type has already been defined)
ListingId Long Integer

The ID of the listing to edit.

RequiredMinimumReserve Number

The required minimum value for the Reserve field. This property will be returned when a listing has bids on it but has not yet met reserve. This field should not be set by consumers.

Example XML Response (switch to JSON)

<EditListingRequest xmlns="http://api.trademe.co.nz/v1">
  <Category>ABC</Category>
  <Title>ABC</Title>
  <Subtitle>ABC</Subtitle>
  <Description>
    <Paragraph>ABC</Paragraph>
    <Paragraph>ABC</Paragraph>
  </Description>
  <StartPrice>123.0</StartPrice>
  <ReservePrice>123.0</ReservePrice>
  <BuyNowPrice>123.0</BuyNowPrice>
  <Duration>EndDate</Duration>
  <EndDateTime>2018-01-01T00:00:00Z</EndDateTime>
  <Pickup>None</Pickup>
  <PickupSuburbId>123</PickupSuburbId>
  <IsBrandNew>false</IsBrandNew>
  <AuthenticatedMembersOnly>false</AuthenticatedMembersOnly>
  <IsClassified>false</IsClassified>
  <OpenHomes>
    <OpenHome>
      <Start>2018-01-01T00:00:00Z</Start>
      <End>2018-01-01T00:00:00Z</End>
    </OpenHome>
    <OpenHome>
      <Start>2018-01-01T00:00:00Z</Start>
      <End>2018-01-01T00:00:00Z</End>
    </OpenHome>
  </OpenHomes>
  <SendPaymentInstructions>false</SendPaymentInstructions>
  <OtherPaymentMethod>ABC</OtherPaymentMethod>
  <IsOrNearOffer>false</IsOrNearOffer>
  <IsPriceOnApplication>false</IsPriceOnApplication>
  <IsBold>false</IsBold>
  <IsFeatured>false</IsFeatured>
  <IsHomepageFeatured>false</IsHomepageFeatured>
  <HasGallery>false</HasGallery>
  <HasGalleryPlus>false</HasGalleryPlus>
  <Quantity>123</Quantity>
  <IsFlatShippingCharge>false</IsFlatShippingCharge>
  <HasAgreedWithLegalNotice>false</HasAgreedWithLegalNotice>
  <HomePhoneNumber>ABC</HomePhoneNumber>
  <MobilePhoneNumber>ABC</MobilePhoneNumber>
  <IsHighlighted>false</IsHighlighted>
  <HasSuperFeature>false</HasSuperFeature>
  <PhotoIds>
    <PhotoId>123</PhotoId>
    <PhotoId>123</PhotoId>
  </PhotoIds>
  <ShippingOptions>
    <ShippingOption>
      <Type>None</Type>
      <Price>123.0</Price>
      <Method>ABC</Method>
    </ShippingOption>
    <ShippingOption>
      <Type>None</Type>
      <Price>123.0</Price>
      <Method>ABC</Method>
    </ShippingOption>
  </ShippingOptions>
  <PaymentMethods>
    <PaymentMethod>None</PaymentMethod>
    <PaymentMethod>None</PaymentMethod>
  </PaymentMethods>
  <Attributes>
    <Attribute>
      <Name>ABC</Name>
      <Value>ABC</Value>
      <Unit>ABC</Unit>
    </Attribute>
    <Attribute>
      <Name>ABC</Name>
      <Value>ABC</Value>
      <Unit>ABC</Unit>
    </Attribute>
  </Attributes>
  <IsClearance>false</IsClearance>
  <ExternalReferenceId>ABC</ExternalReferenceId>
  <Contacts>
    <Contact>
      <FullName>ABC</FullName>
      <PhoneNumber>ABC</PhoneNumber>
      <AlternatePhoneNumber>ABC</AlternatePhoneNumber>
      <EMail>ABC</EMail>
      <BrandingImageId>123</BrandingImageId>
    </Contact>
    <Contact>
      <FullName>ABC</FullName>
      <PhoneNumber>ABC</PhoneNumber>
      <AlternatePhoneNumber>ABC</AlternatePhoneNumber>
      <EMail>ABC</EMail>
      <BrandingImageId>123</BrandingImageId>
    </Contact>
  </Contacts>
  <DonationRecipient>None</DonationRecipient>
  <CatalogueId>ABC</CatalogueId>
  <RemainingGalleryPlusRelists>123</RemainingGalleryPlusRelists>
  <PromotionId>123</PromotionId>
  <ExcludeFromShippingPromotion>false</ExcludeFromShippingPromotion>
  <SKU>ABC</SKU>
  <AvailablePromotions>
    <Promotion>
      <Id>123</Id>
      <Name>ABC</Name>
      <Description>ABC</Description>
      <Price>123.0</Price>
      <OriginalPrice>123.0</OriginalPrice>
      <Recommended>false</Recommended>
      <MinimumPhotoCount>123</MinimumPhotoCount>
      <DiscountDescription>ABC</DiscountDescription>
      <DiscountStartDate>ABC</DiscountStartDate>
      <DiscountEndDate>ABC</DiscountEndDate>
      <DiscountDisclaimer>ABC</DiscountDisclaimer>
      <GoodFor2RelistsFee>123.0</GoodFor2RelistsFee>
    </Promotion>
    <Promotion>
      <Id>123</Id>
      <Name>ABC</Name>
      <Description>ABC</Description>
      <Price>123.0</Price>
      <OriginalPrice>123.0</OriginalPrice>
      <Recommended>false</Recommended>
      <MinimumPhotoCount>123</MinimumPhotoCount>
      <DiscountDescription>ABC</DiscountDescription>
      <DiscountStartDate>ABC</DiscountStartDate>
      <DiscountEndDate>ABC</DiscountEndDate>
      <DiscountDisclaimer>ABC</DiscountDisclaimer>
      <GoodFor2RelistsFee>123.0</GoodFor2RelistsFee>
    </Promotion>
  </AvailablePromotions>
  <ImmutableFields>
    <ImmutableField>ABC</ImmutableField>
    <ImmutableField>ABC</ImmutableField>
  </ImmutableFields>
  <WasPrice>123.0</WasPrice>
  <EmbeddedContent>
    <YouTubeVideoKey>ABC</YouTubeVideoKey>
    <MatterportKey>ABC</MatterportKey>
    <IStagingKey>ABC</IStagingKey>
    <VimeoVideoKey>ABC</VimeoVideoKey>
    <DiakritFurnishKey>ABC</DiakritFurnishKey>
    <DiakritStylerKey>ABC</DiakritStylerKey>
    <DiakritPanoramaKey>ABC</DiakritPanoramaKey>
    <VirtualToursCreatorKey>ABC</VirtualToursCreatorKey>
  </EmbeddedContent>
  <IsBranded>false</IsBranded>
  <ShortDescription>ABC</ShortDescription>
  <AdditionalData>
    <BulletPoints>
      <BulletPoint>ABC</BulletPoint>
      <BulletPoint>ABC</BulletPoint>
    </BulletPoints>
    <Tags>
      <Tag>
        <Name>ABC</Name>
      </Tag>
      <Tag>
        <Name>ABC</Name>
      </Tag>
    </Tags>
  </AdditionalData>
  <VariantDefinition>
    <OptionSets>
      <OptionSet>
        <Name>ABC</Name>
        <Values>
          <Value>ABC</Value>
          <Value>ABC</Value>
        </Values>
      </OptionSet>
      <OptionSet>
        <Name>ABC</Name>
        <Values>
          <Value>ABC</Value>
          <Value>ABC</Value>
        </Values>
      </OptionSet>
    </OptionSets>
    <Variants>
      <Variant>
        <SKU>ABC</SKU>
        <Price>123.0</Price>
        <IsClearance>false</IsClearance>
        <WasPrice>123.0</WasPrice>
        <Quantity>123</Quantity>
        <Photos>
          <Photo>
            <PhotoId>123</PhotoId>
            <Value>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
              <PhotoId>123</PhotoId>
            </Value>
          </Photo>
          <Photo>
            <PhotoId>123</PhotoId>
            <Value>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
              <PhotoId>123</PhotoId>
            </Value>
          </Photo>
        </Photos>
        <Options>
          <Option>
            <Name>ABC</Name>
            <Value>ABC</Value>
          </Option>
          <Option>
            <Name>ABC</Name>
            <Value>ABC</Value>
          </Option>
        </Options>
        <Attributes>
          <Attribute />
          <Attribute />
        </Attributes>
        <ListingId>123</ListingId>
        <ProductSpecification>
          <GTIN>ABC</GTIN>
          <Brand>ABC</Brand>
          <ManufacturerCode>ABC</ManufacturerCode>
        </ProductSpecification>
      </Variant>
      <Variant>
        <SKU>ABC</SKU>
        <Price>123.0</Price>
        <IsClearance>false</IsClearance>
        <WasPrice>123.0</WasPrice>
        <Quantity>123</Quantity>
        <Photos>
          <Photo>
            <PhotoId>123</PhotoId>
            <Value>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
              <PhotoId>123</PhotoId>
            </Value>
          </Photo>
          <Photo>
            <PhotoId>123</PhotoId>
            <Value>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
              <PhotoId>123</PhotoId>
            </Value>
          </Photo>
        </Photos>
        <Options>
          <Option>
            <Name>ABC</Name>
            <Value>ABC</Value>
          </Option>
          <Option>
            <Name>ABC</Name>
            <Value>ABC</Value>
          </Option>
        </Options>
        <Attributes>
          <Attribute />
          <Attribute />
        </Attributes>
        <ListingId>123</ListingId>
        <ProductSpecification>
          <GTIN>ABC</GTIN>
          <Brand>ABC</Brand>
          <ManufacturerCode>ABC</ManufacturerCode>
        </ProductSpecification>
      </Variant>
    </Variants>
  </VariantDefinition>
  <SecondCategory>ABC</SecondCategory>
  <PremiumPackageCode>ABC</PremiumPackageCode>
  <ProductSpecification />
  <ListingExtrasLedger>
    <ListingExtras />
    <ListingExtras />
  </ListingExtrasLedger>
  <HasGoodFor2Relists>false</HasGoodFor2Relists>
  <IsOffersAllowed>false</IsOffersAllowed>
  <IsCounterOffersAllowed>false</IsCounterOffersAllowed>
  <MaximumOffers>123</MaximumOffers>
  <Photos>
    <Photo>
      <PhotoId>123</PhotoId>
      <Value />
    </Photo>
    <Photo>
      <PhotoId>123</PhotoId>
      <Value />
    </Photo>
  </Photos>
  <ListingId>123</ListingId>
  <RequiredMinimumReserve>123.0</RequiredMinimumReserve>
</EditListingRequest>

Example JSON Response (switch to XML)

{
  "Category": "ABC",
  "Title": "ABC",
  "Subtitle": "ABC",
  "Description": [
    "ABC",
    "ABC"
  ],
  "StartPrice": 123.0,
  "ReservePrice": 123.0,
  "BuyNowPrice": 123.0,
  "Duration": 0,
  "EndDateTime": "\/Date(1514764800)\/",
  "Pickup": 0,
  "PickupSuburbId": 123,
  "IsBrandNew": false,
  "AuthenticatedMembersOnly": false,
  "IsClassified": false,
  "OpenHomes": [
    {
      "Start": "\/Date(1514764800)\/",
      "End": "\/Date(1514764800)\/"
    },
    {
      "Start": "\/Date(1514764800)\/",
      "End": "\/Date(1514764800)\/"
    }
  ],
  "SendPaymentInstructions": false,
  "OtherPaymentMethod": "ABC",
  "IsOrNearOffer": false,
  "IsPriceOnApplication": false,
  "IsBold": false,
  "IsFeatured": false,
  "IsHomepageFeatured": false,
  "HasGallery": false,
  "HasGalleryPlus": false,
  "Quantity": 123,
  "IsFlatShippingCharge": false,
  "HasAgreedWithLegalNotice": false,
  "HomePhoneNumber": "ABC",
  "MobilePhoneNumber": "ABC",
  "IsHighlighted": false,
  "HasSuperFeature": false,
  "PhotoIds": [
    123,
    123
  ],
  "ShippingOptions": [
    {
      "Type": 0,
      "Price": 123.0,
      "Method": "ABC"
    },
    {
      "Type": 0,
      "Price": 123.0,
      "Method": "ABC"
    }
  ],
  "PaymentMethods": [
    0,
    0
  ],
  "Attributes": [
    {
      "Name": "ABC",
      "Value": "ABC",
      "Unit": "ABC"
    },
    {
      "Name": "ABC",
      "Value": "ABC",
      "Unit": "ABC"
    }
  ],
  "IsClearance": false,
  "ExternalReferenceId": "ABC",
  "Contacts": [
    {
      "FullName": "ABC",
      "PhoneNumber": "ABC",
      "AlternatePhoneNumber": "ABC",
      "EMail": "ABC",
      "BrandingImageId": 123
    },
    {
      "FullName": "ABC",
      "PhoneNumber": "ABC",
      "AlternatePhoneNumber": "ABC",
      "EMail": "ABC",
      "BrandingImageId": 123
    }
  ],
  "DonationRecipient": 0,
  "CatalogueId": "ABC",
  "RemainingGalleryPlusRelists": 123,
  "PromotionId": 123,
  "ExcludeFromShippingPromotion": false,
  "SKU": "ABC",
  "AvailablePromotions": [
    {
      "Id": 123,
      "Name": "ABC",
      "Description": "ABC",
      "Price": 123.0,
      "OriginalPrice": 123.0,
      "Recommended": false,
      "MinimumPhotoCount": 123,
      "DiscountDescription": "ABC",
      "DiscountStartDate": "ABC",
      "DiscountEndDate": "ABC",
      "DiscountDisclaimer": "ABC",
      "GoodFor2RelistsFee": 123.0
    },
    {
      "Id": 123,
      "Name": "ABC",
      "Description": "ABC",
      "Price": 123.0,
      "OriginalPrice": 123.0,
      "Recommended": false,
      "MinimumPhotoCount": 123,
      "DiscountDescription": "ABC",
      "DiscountStartDate": "ABC",
      "DiscountEndDate": "ABC",
      "DiscountDisclaimer": "ABC",
      "GoodFor2RelistsFee": 123.0
    }
  ],
  "ImmutableFields": [
    "ABC",
    "ABC"
  ],
  "WasPrice": 123.0,
  "EmbeddedContent": {
    "YouTubeVideoKey": "ABC",
    "MatterportKey": "ABC",
    "IStagingKey": "ABC",
    "VimeoVideoKey": "ABC",
    "DiakritFurnishKey": "ABC",
    "DiakritStylerKey": "ABC",
    "DiakritPanoramaKey": "ABC",
    "VirtualToursCreatorKey": "ABC"
  },
  "IsBranded": false,
  "ShortDescription": "ABC",
  "AdditionalData": {
    "BulletPoints": [
      "ABC",
      "ABC"
    ],
    "Tags": [
      {
        "Name": "ABC"
      },
      {
        "Name": "ABC"
      }
    ]
  },
  "VariantDefinition": {
    "OptionSets": [
      {
        "Name": "ABC",
        "Values": [
          "ABC",
          "ABC"
        ]
      },
      {
        "Name": "ABC",
        "Values": [
          "ABC",
          "ABC"
        ]
      }
    ],
    "Variants": [
      {
        "SKU": "ABC",
        "Price": 123.0,
        "IsClearance": false,
        "WasPrice": 123.0,
        "Quantity": 123,
        "Photos": [
          {
            "Key": 123,
            "Value": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC",
              "PhotoId": 123
            }
          },
          {
            "Key": 123,
            "Value": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC",
              "PhotoId": 123
            }
          }
        ],
        "Options": [
          {
            "Name": "ABC",
            "Value": "ABC"
          },
          {
            "Name": "ABC",
            "Value": "ABC"
          }
        ],
        "Attributes": [
          {
          },
          {
          }
        ],
        "ListingId": 123,
        "ProductSpecification": {
          "GTIN": "ABC",
          "Brand": "ABC",
          "ManufacturerCode": "ABC"
        }
      },
      {
        "SKU": "ABC",
        "Price": 123.0,
        "IsClearance": false,
        "WasPrice": 123.0,
        "Quantity": 123,
        "Photos": [
          {
            "Key": 123,
            "Value": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC",
              "PhotoId": 123
            }
          },
          {
            "Key": 123,
            "Value": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC",
              "PhotoId": 123
            }
          }
        ],
        "Options": [
          {
            "Name": "ABC",
            "Value": "ABC"
          },
          {
            "Name": "ABC",
            "Value": "ABC"
          }
        ],
        "Attributes": [
          {
          },
          {
          }
        ],
        "ListingId": 123,
        "ProductSpecification": {
          "GTIN": "ABC",
          "Brand": "ABC",
          "ManufacturerCode": "ABC"
        }
      }
    ]
  },
  "SecondCategory": "ABC",
  "PremiumPackageCode": "ABC",
  "ProductSpecification": {
  },
  "ListingExtrasLedger": [
    {
    },
    {
    }
  ],
  "HasGoodFor2Relists": false,
  "IsOffersAllowed": false,
  "IsCounterOffersAllowed": false,
  "MaximumOffers": 123,
  "Photos": [
    {
      "Key": 123,
      "Value": {
      }
    },
    {
      "Key": 123,
      "Value": {
      }
    }
  ],
  "ListingId": 123,
  "RequiredMinimumReserve": 123.0
}