EndFixedPriceItem

Use this call to end the specified fixed-price listing before the date and time at which it would normally end (per the listing duration).

While you can also use EndItem to end fixed-price listings, EndFixedPriceItem has the following differences from EndItem:

• If the seller listed the item with SKU-based inventory tracking, EndFixedPriceItem gives you an option to end the listing by SKU instead of by ItemID.
• The call supports only fixed-price listings (not auctions).
• The call supports the ending of multi-variation listings.
• If needed, you can end listings in bulk using the File Transfer API and the Bulk Data Exchange API.

Only the item's seller can use EndFixedPriceItem to end an item listing. The item can be identified by the ItemID or (in certain cases) the seller's SKU.

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.

You can test this call in the Sandbox environment.

See End a listing early.

See also the reference documentation for these calls:

• EndItem - Ends the specified item listing before the date and time at which it would normally end per the listing duration.
• EndItems - The EndItems call is used to end up to 10 specified eBay listings before the date and time at which those listings would normally end per the listing duration.

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"?>
<EndFixedPriceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <EndingReason> EndReasonCodeType </EndingReason>
  <ItemID> ItemIDType (string) </ItemID>
  <SKU> SKUType (string) </SKU>
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</EndFixedPriceItemRequest>

Output

See also Samples.

The box below lists all fields that might be returned in the response. 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 not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<EndFixedPriceItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <EndTime> dateTime </EndTime>
  <SKU> SKUType (string) </SKU>
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</EndFixedPriceItemResponse>

Detail Controls

DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

The following sample shows how to end a fixed-price listing.

Description

A salesperson from m****************t has determined that some of the details in a fixed price listing are incorrect. As the listing already has some sales, he can't correct the necessary details. To avoid confusing buyers and risking concerns that the items are not as he describes, he decides to end the listing (and he'll later create a new one).

Input

The request include the ItemID of the listing, and the reason he wants to end it.

XML format.

<?<?xml version="1.0" encoding="utf-8"?>
<EndFixedPriceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ItemID>1**********4</ItemID>
  <EndingReason>NotAvailable</EndingReason>
  <RequesterCredentials>
    <eBayAuthToken>A*******3</eBayAuthToken>
  </RequesterCredentials>
</EndFixedPriceItemRequest>

Output

The response indicates that the listing was ended successfully, and it shows the time the listing was ended.

As a result of successfully submitting this request, eBay's View Item page and GetItem show buyers that the listing has ended.

XML format.
<?xml version="1.0" encoding="utf-8"?>
<EndFixedPriceItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2019-11-04T17:33:35.145Z</Timestamp>
  <Ack>Success</Ack>
  <Version>1131</Version>
  <Build>E1131_UNI_API5_19098188_R1</Build>
  <EndTime>2019-11-04T17:33:35.038Z</EndTime>
</EndFixedPriceItemResponse>

Change History