RelistItem

Use this call to relist a single auction-style item that has ended. The item may be relisted as it was originally defined, or the seller may change a number of the item's listing properties.

Note: If the item was being watched when the listing ended, it will continue to be watched when the item is relisted.

To relist an item, you must be the user who listed the original item. In addition, the original item's listing must have ended, and the relisting must be done within 90 days of the end of the original listing.

To relist multiple listings, call RelistItem once for each item to be relisted. Note that if you call RelistItem multiple times with the same ItemID, each call results in a new listing with a different item ID for each listing.

To relist a fixed-price item, a single multi-item listing, or a multi-variation listing, use RelistFixedPriceItem. For Best Match information related to multi-variation listings, see Multi-quantity Fixed Price listings with variations. If you are considering an item's rank (placement) in search results, see Considering Best Match When Revising and Relisting Items.

Usage Details

When calling RelistItem, supply the ItemID of the ended listing and an Item object that contains any changes that you want to make from the original listing. By default, all the original item features are rolled over to the new item definition. You can add new listing features to the Item container and you can remove any features from the original listing that you do not want rolled into the new listing. The DeletedField container provides the means to remove many existing listing features (see the DeletedField documentation below for more information). However, not all listing features can be removed using DeletedField. See Best practices for relisting items for details.

The Type documentation for ItemType has a complete list of the ItemType properties, their definitions, and their validation rules. For a detailed step-by-step description of the relist process, and for details on how to specify property changes, see Relisting Items.

If you plan to change listing properties when you relist an item, it can be a good idea to test the new listing definition with VerifyRelistItem before you relist the item with RelistItem. To do so, create your RelistItem call, setting all the properties that you plan to use for the relisted item. Use that exact call, but call VerifyRelistItem instead. This helps to ensure your new listing definition is valid, and you can review the response for an estimation of the listing fees that will be incurred if you relist the item.

If you are relisting an item that was administratively canceled due to an eBay listing policy violation, make sure that the GetItem response for the item returns Item.SellingStatus.AdminEnded as true.

As with all listing calls, the site you specify in the request URL (for SOAP) or the X-EBAY-API-SITEID HTTP header (for XML) should match the original listing's Item.Site value. In particular, this is a best practice when you submit new and modified listings.

Note to Sell Feed API users: When you use this call with the Sell Feed API, you must wrap the file to be uploaded within BulkDataExchangeRequest tags, which will also be returned in the response. This container is not shown in the standard Input/Output sections for this call. See XML data files overview in the LMS Feed API Guide for additional information.

Working with the Response

After calling RelistItem, the response contains an ItemID property with the listing's new item ID. The StartTime and EndTime fields define when the listing is active, and the Fees container provides details on the cost of relisting the item. See Fees Resulting from Listing an Item for fee details. If no items from the listing sold, you might be eligible for a relisting credit; see What is the Free Relist Policy for details.

Under many circumstances, an item is qualified to be relisted for no additional fees. (Although a new InsertionFee is always returned when you relist an item, this fee is often credited to the sellers account. See Getting credited for the insertion fee for more details). With this, the values in the child elements of the Fees object often contain zero values. However, if you have made changes to the original item properties such that a fee-based option is used in the new listing (where it was not used in the original listing), then the fees for the relist will reflect this with non-zero Fee values. In addition, some features always incur a listing fee, even with an item relist. Use VerifyRelistItem if you are unsure of which features will result in new fees when you relist an item.

When you list an item, you're charged an Insertion Fee that is based on the starting price (or reserve price) and category of your item. If you relist your item for a lower starting price, the insertion fee is not credited. The insertion fee charged is based on the highest starting price for any of the item's insertions.

Testing RelistItem

You can test RelistItem in the Sandbox. To test the call, you must have an item that has ended and for which the test user is the one that originally listed the item. If such an item listing does not already exist, create one using AddItem, and end the listing with EndItem (set EndingReason to NotAvailable to end the item without waiting for the listing to expire). Ensure that the test user in the Sandbox environment has sufficient feedback and other qualifications to relist the desired type of item.

After relisting an item, use a data retrieval call like GetSellerList or GetItem to retrieve the data for the item that was relisted. Verify that the listing has all of the desired values. This is especially important when item properties were changed to values different than those in the original listing. Verify that the changes were what was desired and intended.

Related Information

See:
    Relist Items
    Best practices for relisting items
    Relisting items (eBay Help page)

See also the reference documentation for these calls:

• RelistFixedPriceItem - Enables a seller to relist a fixed-price listing that has recently ended on a specified eBay site.
• VerifyRelistItem - Enable the seller to verify that the data they plan to pass into a RelistItem call will produce the results that you are expecting, including a successful call with no errors.

Input

See also Samples.

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls).

<?xml version="1.0" encoding="utf-8"?>
<RelistItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <DeletedField> string </DeletedField>
  <!-- ... more DeletedField values allowed here ... -->
  <Item> ItemType
    <ApplicationData> string </ApplicationData>
    <AutoPay> boolean </AutoPay>
    <BestOfferDetails> BestOfferDetailsType
      <BestOfferEnabled> boolean </BestOfferEnabled>
    </BestOfferDetails>
    <BuyerResponsibleForShipping> boolean </BuyerResponsibleForShipping>
    <BuyItNowPrice currencyID="CurrencyCodeType"> AmountType (double) </BuyItNowPrice>
    <CategoryMappingAllowed> boolean </CategoryMappingAllowed>
    <Charity> CharityType
      <CharityID> string </CharityID>
      <DonationPercent> float </DonationPercent>
    </Charity>
    <ConditionDescription> string </ConditionDescription>
    <ConditionDescriptors> ConditionDescriptorsType
      <ConditionDescriptor> ConditionDescriptorType
        <AdditionalInfo> string </AdditionalInfo>
        <Name> string </Name>
        <Value> string </Value>
        <!-- ... more Value values allowed here ... -->
      </ConditionDescriptor>
      <!-- ... more ConditionDescriptor nodes allowed here ... -->
    </ConditionDescriptors>
    <ConditionID> int </ConditionID>
    <Country> CountryCodeType </Country>
    <CrossBorderTrade> string </CrossBorderTrade>
    <!-- ... more CrossBorderTrade values allowed here ... -->
    <CustomPolicies> CustomPoliciesType
      <ProductCompliancePolicyID> long </ProductCompliancePolicyID>
      <!-- ... more ProductCompliancePolicyID values allowed here ... -->
      <RegionalProductCompliancePolicies> CountryPoliciesArrayType
        <CountryPolicies> CountryPoliciesType
          <Country> CountryCodeType </Country>
          <PolicyID> long </PolicyID>
          <!-- ... more PolicyID values allowed here ... -->
        </CountryPolicies>
        <!-- ... more CountryPolicies nodes allowed here ... -->
      </RegionalProductCompliancePolicies>
      <RegionalTakeBackPolicies> CountryPoliciesArrayType
        <CountryPolicies> CountryPoliciesType
          <Country> CountryCodeType </Country>
          <PolicyID> long </PolicyID>
          <!-- ... more PolicyID values allowed here ... -->
        </CountryPolicies>
        <!-- ... more CountryPolicies nodes allowed here ... -->
      </RegionalTakeBackPolicies>
      <TakeBackPolicyID> long </TakeBackPolicyID>
    </CustomPolicies>
    <Description> string </Description>
    <DigitalGoodInfo> DigitalGoodInfoType
      <DigitalDelivery> boolean </DigitalDelivery>
    </DigitalGoodInfo>
    <DisableBuyerRequirements> boolean </DisableBuyerRequirements>
    <DiscountPriceInfo> DiscountPriceInfoType
      <MadeForOutletComparisonPrice currencyID="CurrencyCodeType"> AmountType (double) </MadeForOutletComparisonPrice>
      <MinimumAdvertisedPrice currencyID="CurrencyCodeType"> AmountType (double) </MinimumAdvertisedPrice>
      <MinimumAdvertisedPriceExposure> MinimumAdvertisedPriceExposureCodeType </MinimumAdvertisedPriceExposure>
      <OriginalRetailPrice currencyID="CurrencyCodeType"> AmountType (double) </OriginalRetailPrice>
      <SoldOffeBay> boolean </SoldOffeBay>
      <SoldOneBay> boolean </SoldOneBay>
    </DiscountPriceInfo>
    <DispatchTimeMax> int </DispatchTimeMax>
    <eBayPlus> boolean </eBayPlus>
    <ExtendedProducerResponsibility> ExtendedProducerResponsibilityType
      <EcoParticipationFee currencyID="CurrencyCodeType"> AmountType (double) </EcoParticipationFee>
    </ExtendedProducerResponsibility>
    <ExtendedSellerContactDetails> ExtendedContactDetailsType
      <ClassifiedAdContactByEmailEnabled> boolean </ClassifiedAdContactByEmailEnabled>
      <ContactHoursDetails> ContactHoursDetailsType
        <Hours1AnyTime> boolean </Hours1AnyTime>
        <Hours1Days> DaysCodeType </Hours1Days>
        <Hours1From> time </Hours1From>
        <Hours1To> time </Hours1To>
        <Hours2AnyTime> boolean </Hours2AnyTime>
        <Hours2Days> DaysCodeType </Hours2Days>
        <Hours2From> time </Hours2From>
        <Hours2To> time </Hours2To>
        <TimeZoneID> string </TimeZoneID>
      </ContactHoursDetails>
    </ExtendedSellerContactDetails>
    <ItemCompatibilityList> ItemCompatibilityListType
      <Compatibility> ItemCompatibilityType
        <CompatibilityNotes> string </CompatibilityNotes>
        <NameValueList> NameValueListType
          <Name> string </Name>
          <Value> string </Value>
          <!-- ... more Value values allowed here ... -->
        </NameValueList>
        <!-- ... more NameValueList nodes allowed here ... -->
      </Compatibility>
      <!-- ... more Compatibility nodes allowed here ... -->
      <ReplaceAll> boolean </ReplaceAll>
    </ItemCompatibilityList>
    <ItemID> ItemIDType (string) </ItemID>
    <ItemSpecifics> NameValueListArrayType
      <NameValueList> NameValueListType
        <Name> string </Name>
        <Value> string </Value>
        <!-- ... more Value values allowed here ... -->
      </NameValueList>
      <!-- ... more NameValueList nodes allowed here ... -->
    </ItemSpecifics>
    <ListingDetails> ListingDetailsType
      <BestOfferAutoAcceptPrice currencyID="CurrencyCodeType"> AmountType (double) </BestOfferAutoAcceptPrice>
      <MinimumBestOfferPrice currencyID="CurrencyCodeType"> AmountType (double) </MinimumBestOfferPrice>
    </ListingDetails>
    <ListingDuration> token </ListingDuration>
    <ListingEnhancement> ListingEnhancementsCodeType </ListingEnhancement>
    <!-- ... more ListingEnhancement values allowed here ... -->
    <ListingSubtype2> ListingSubtypeCodeType </ListingSubtype2>
    <ListingType> ListingTypeCodeType </ListingType>
    <Location> string </Location>
    <LotSize> int </LotSize>
    <PaymentDetails> PaymentDetailsType
      <DaysToFullPayment> int </DaysToFullPayment>
      <DepositAmount currencyID="CurrencyCodeType"> AmountType (double) </DepositAmount>
      <DepositType> DepositTypeCodeType </DepositType>
      <HoursToDeposit> int </HoursToDeposit>
    </PaymentDetails>
    <PaymentMethods> BuyerPaymentMethodCodeType </PaymentMethods>
    <!-- ... more PaymentMethods values allowed here ... -->
    <PayPalEmailAddress> string </PayPalEmailAddress>
    <PickupInStoreDetails> PickupInStoreDetailsType
      <EligibleForPickupInStore> boolean </EligibleForPickupInStore>
    </PickupInStoreDetails>
    <PictureDetails> PictureDetailsType
      <GalleryType> GalleryTypeCodeType </GalleryType>
      <PictureURL> anyURI </PictureURL>
      <!-- ... more PictureURL values allowed here ... -->
    </PictureDetails>
    <PostalCode> string </PostalCode>
    <PrimaryCategory> CategoryType
      <CategoryID> string </CategoryID>
    </PrimaryCategory>
    <PrivateListing> boolean </PrivateListing>
    <PrivateNotes> string </PrivateNotes>
    <ProductListingDetails> ProductListingDetailsType
      <BrandMPN> BrandMPNType
        <Brand> string </Brand>
        <MPN> string </MPN>
      </BrandMPN>
      <EAN> string </EAN>
      <IncludeeBayProductDetails> boolean </IncludeeBayProductDetails>
      <IncludeStockPhotoURL> boolean </IncludeStockPhotoURL>
      <ISBN> string </ISBN>
      <ProductReferenceID> string </ProductReferenceID>
      <ReturnSearchResultOnDuplicates> boolean </ReturnSearchResultOnDuplicates>
      <UPC> string </UPC>
      <UseFirstProduct> boolean </UseFirstProduct>
      <UseStockPhotoURLAsGallery> boolean </UseStockPhotoURLAsGallery>
    </ProductListingDetails>
    <Quantity> int </Quantity>
    <QuantityRestrictionPerBuyer> QuantityRestrictionPerBuyerInfoType
      <MaximumQuantity> int </MaximumQuantity>
    </QuantityRestrictionPerBuyer>
    <Regulatory> RegulatoryType
      <Documents> DocumentsType
        <Document> DocumentType
          <DocumentID> string </DocumentID>
        </Document>
        <!-- ... more Document nodes allowed here ... -->
      </Documents>
      <EnergyEfficiencyLabel> EnergyEfficiencyType
        <ImageDescription> string </ImageDescription>
        <ImageURL> anyURI </ImageURL>
        <ProductInformationsheet> anyURI </ProductInformationsheet>
      </EnergyEfficiencyLabel>
      <Hazmat> HazmatType
        <Component> string </Component>
        <Pictograms> PictogramsType
          <Pictogram> string </Pictogram>
          <!-- ... more Pictogram values allowed here ... -->
        </Pictograms>
        <SignalWord> string </SignalWord>
        <Statements> StatementsType
          <Statement> string </Statement>
          <!-- ... more Statement values allowed here ... -->
        </Statements>
      </Hazmat>
      <Manufacturer> ManufacturerType
        <CityName> string </CityName>
        <CompanyName> string </CompanyName>
        <Country> CountryCodeType </Country>
        <Email> string </Email>
        <Phone> string </Phone>
        <PostalCode> string </PostalCode>
        <StateOrProvince> string </StateOrProvince>
        <Street1> string </Street1>
        <Street2> string </Street2>
      </Manufacturer>
      <ProductSafety> ProductSafetyType
        <Component> string </Component>
        <Pictograms> PictogramsType
          <Pictogram> string </Pictogram>
          <!-- ... more Pictogram values allowed here ... -->
        </Pictograms>
        <Statements> StatementsType
          <Statement> string </Statement>
          <!-- ... more Statement values allowed here ... -->
        </Statements>
      </ProductSafety>
      <RepairScore> double </RepairScore>
      <ResponsiblePersons> ResponsiblePersonsType
        <ResponsiblePerson> ResponsiblePersonType
          <CityName> string </CityName>
          <CompanyName> string </CompanyName>
          <Country> CountryCodeType </Country>
          <Email> string </Email>
          <Phone> string </Phone>
          <PostalCode> string </PostalCode>
          <StateOrProvince> string </StateOrProvince>
          <Street1> string </Street1>
          <Street2> string </Street2>
          <Types> ResponsiblePersonCodeTypes
            <Type> ResponsiblePersonCodeType </Type>
            <!-- ... more Type values allowed here ... -->
          </Types>
        </ResponsiblePerson>
        <!-- ... more ResponsiblePerson nodes allowed here ... -->
      </ResponsiblePersons>
    </Regulatory>
    <RelistLink> boolean </RelistLink>
    <ReservePrice currencyID="CurrencyCodeType"> AmountType (double) </ReservePrice>
    <ReturnPolicy> ReturnPolicyType
      <Description> string </Description>
      <InternationalRefundOption> token </InternationalRefundOption>
      <InternationalReturnsAcceptedOption> token </InternationalReturnsAcceptedOption>
      <InternationalReturnsWithinOption> token </InternationalReturnsWithinOption>
      <InternationalShippingCostPaidByOption> token </InternationalShippingCostPaidByOption>
      <RefundOption> token </RefundOption>
      <ReturnsAcceptedOption> token </ReturnsAcceptedOption>
      <ReturnsWithinOption> token </ReturnsWithinOption>
      <ShippingCostPaidByOption> token </ShippingCostPaidByOption>
    </ReturnPolicy>
    <ScheduleTime> dateTime </ScheduleTime>
    <SecondaryCategory> CategoryType
      <CategoryID> string </CategoryID>
    </SecondaryCategory>
    <SellerContactDetails> AddressType
      <CompanyName> string </CompanyName>
      <County> string </County>
      <PhoneAreaOrCityCode> string </PhoneAreaOrCityCode>
      <PhoneCountryCode> CountryCodeType </PhoneCountryCode>
      <PhoneLocalNumber> string </PhoneLocalNumber>
      <Street> string </Street>
      <Street2> string </Street2>
    </SellerContactDetails>
    <SellerProfiles> SellerProfilesType
      <SellerPaymentProfile> SellerPaymentProfileType
        <PaymentProfileID> long </PaymentProfileID>
        <PaymentProfileName> string </PaymentProfileName>
      </SellerPaymentProfile>
      <SellerReturnProfile> SellerReturnProfileType
        <ReturnProfileID> long </ReturnProfileID>
        <ReturnProfileName> string </ReturnProfileName>
      </SellerReturnProfile>
      <SellerShippingProfile> SellerShippingProfileType
        <ShippingProfileID> long </ShippingProfileID>
        <ShippingProfileName> string </ShippingProfileName>
      </SellerShippingProfile>
    </SellerProfiles>
    <SellerProvidedTitle> string </SellerProvidedTitle>
    <ShippingDetails> ShippingDetailsType
      <CalculatedShippingRate> CalculatedShippingRateType
        <InternationalPackagingHandlingCosts currencyID="CurrencyCodeType"> AmountType (double) </InternationalPackagingHandlingCosts>
        <PackagingHandlingCosts currencyID="CurrencyCodeType"> AmountType (double) </PackagingHandlingCosts>
      </CalculatedShippingRate>
      <ExcludeShipToLocation> string </ExcludeShipToLocation>
      <!-- ... more ExcludeShipToLocation values allowed here ... -->
      <GlobalShipping> boolean </GlobalShipping>
      <InternationalPromotionalShippingDiscount> boolean </InternationalPromotionalShippingDiscount>
      <InternationalShippingDiscountProfileID> string </InternationalShippingDiscountProfileID>
      <InternationalShippingServiceOption> InternationalShippingServiceOptionsType
        <ShippingService> token </ShippingService>
        <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
        <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
        <ShippingServicePriority> int </ShippingServicePriority>
        <ShipToLocation> string </ShipToLocation>
        <!-- ... more ShipToLocation values allowed here ... -->
      </InternationalShippingServiceOption>
      <!-- ... more InternationalShippingServiceOption nodes allowed here ... -->
      <PromotionalShippingDiscount> boolean </PromotionalShippingDiscount>
      <RateTableDetails> RateTableDetailsType
        <DomesticRateTable> string </DomesticRateTable>
        <DomesticRateTableId> string </DomesticRateTableId>
        <InternationalRateTable> string </InternationalRateTable>
        <InternationalRateTableId> string </InternationalRateTableId>
      </RateTableDetails>
      <SalesTax> SalesTaxType
        <SalesTaxPercent> float </SalesTaxPercent>
        <SalesTaxState> string </SalesTaxState>
        <ShippingIncludedInTax> boolean </ShippingIncludedInTax>
      </SalesTax>
      <ShippingDiscountProfileID> string </ShippingDiscountProfileID>
      <ShippingServiceOptions> ShippingServiceOptionsType
        <FreeShipping> boolean </FreeShipping>
        <ShippingService> token </ShippingService>
        <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
        <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
        <ShippingServicePriority> int </ShippingServicePriority>
      </ShippingServiceOptions>
      <!-- ... more ShippingServiceOptions nodes allowed here ... -->
      <ShippingType> ShippingTypeCodeType </ShippingType>
    </ShippingDetails>
    <ShippingPackageDetails> ShipPackageDetailsType
      <MeasurementUnit> MeasurementSystemCodeType </MeasurementUnit>
      <PackageDepth> MeasureType (decimal) </PackageDepth>
      <PackageLength> MeasureType (decimal) </PackageLength>
      <PackageWidth> MeasureType (decimal) </PackageWidth>
      <ShippingIrregular> boolean </ShippingIrregular>
      <ShippingPackage> ShippingPackageCodeType </ShippingPackage>
      <WeightMajor> MeasureType (decimal) </WeightMajor>
      <WeightMinor> MeasureType (decimal) </WeightMinor>
    </ShippingPackageDetails>
    <ShippingServiceCostOverrideList> ShippingServiceCostOverrideListType
      <ShippingServiceCostOverride> ShippingServiceCostOverrideType
        <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
        <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
        <ShippingServicePriority> int </ShippingServicePriority>
        <ShippingServiceType> ShippingServiceType </ShippingServiceType>
      </ShippingServiceCostOverride>
      <!-- ... more ShippingServiceCostOverride nodes allowed here ... -->
    </ShippingServiceCostOverrideList>
    <ShipToLocations> string </ShipToLocations>
    <!-- ... more ShipToLocations values allowed here ... -->
    <Site> SiteCodeType </Site>
    <SKU> SKUType (string) </SKU>
    <StartPrice currencyID="CurrencyCodeType"> AmountType (double) </StartPrice>
    <Storefront> StorefrontType
      <StoreCategory2ID> long </StoreCategory2ID>
      <StoreCategory2Name> string </StoreCategory2Name>
      <StoreCategoryID> long </StoreCategoryID>
      <StoreCategoryName> string </StoreCategoryName>
    </Storefront>
    <SubTitle> string </SubTitle>
    <TaxCategory> string </TaxCategory>
    <Title> string </Title>
    <UseTaxTable> boolean </UseTaxTable>
    <UUID> UUIDType (string) </UUID>
    <VATDetails> VATDetailsType
      <BusinessSeller> boolean </BusinessSeller>
      <RestrictedToBusiness> boolean </RestrictedToBusiness>
      <VATPercent> float </VATPercent>
    </VATDetails>
    <VideoDetails> VideoDetailsType
      <VideoID> string </VideoID>
      <!-- ... more VideoID values allowed here ... -->
    </VideoDetails>
    <VIN> string </VIN>
    <VRM> string </VRM>
  </Item>
  <!-- Standard Input Fields -->
  <ErrorHandling> ErrorHandlingCodeType </ErrorHandling>
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</RelistItemRequest>

 Item.ListingDetails.BestOfferAutoAcceptPrice 

 Item.ListingDetails.BestOfferAutoAcceptPrice 

 Item.ListingDetails.MinimumBestOfferPrice 

 Item.ListingDetails.MinimumBestOfferPrice