Skip to main content

DELETE/inventory_item/{sku}

This call is used to delete an inventory item record associated with a specified SKU. A successful call will not only delete that inventory item record, but will also have the following effects:

  • Delete any and all unpublished offers associated with that SKU;
  • Delete any and all single-variation eBay listings associated with that SKU;
  • Automatically remove that SKU from a multiple-variation listing and remove that SKU from any and all inventory item groups in which that SKU was a member.

The authorization header is the only required HTTP header for this call. See the HTTP request headers section for more information.

Input

Resource URI

DELETE https://api.ebay.com/sell/inventory/v1/inventory_item/{sku}

This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com root URI with api.sandbox.ebay.com

URI parameters

ParameterTypeDescription
skustringThis path parameter specifies the seller-defined SKU value of the product whose inventory item record you wish to delete.

Use the getInventoryItems method to retrieve SKU values.

Max length: 50

Occurrence: Required

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

All other standard RESTful request headers are optional. For more information on standard RESTful request headers, see the HTTP request headers- opens rest request components page table.

OAuth scope

This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):

https://api.ebay.com/oauth/api_scope/sell.inventory

See OAuth access tokens for more information.

Request payload

This call has no payload.

Request fields

This call has no field definitions.

Output

HTTP response headers

This call has no response headers.

Response payload

This call has no payload.

Response fields

This call has no field definitions.

HTTP status codes

This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.

StatusMeaning
204No Content
400Bad Request
404Not Found
500Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

CodeDomainCategoryMeaning
25001API_INVENTORYAPPLICATIONA system error has occurred. {additionalInfo}
25702API_INVENTORYREQUEST{skuValue} could not be found or is not available in the system.
25709API_INVENTORYREQUESTInvalid value for {fieldName}. {additionalInfo}
25710API_INVENTORYREQUESTWe didn't find the resource/entity you are requesting. Please verify the request

Warnings

This call has no warnings.

Samples

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

Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.

Sample 1: Deleting an Inventory Item

This call will delete a specific inventory item associated to the seller's acount.

Input

The SKU value associated with the inventory item to delete is input into the end of the call URI. In this case, the SKU value for the inventory item is G********1.

DELETEhttps://api.ebay.com/sell/inventory/v1/inventory_item/G********1

Output

There is no output payload with this response. A successful call contains an HTTP status code of 204 (No Content).