deleteListingsItem

delete https://sellingpartnerapi-na.amazon.com/listings/2020-09-01/items/{sellerId}/{sku}

Delete a listings item for a selling partner.

Note: The parameters associated with this operation may contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when encoding URLs, refer to URL Encoding.

Usage Plan:

Rate (requests per second)	Burst
5	10

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Responses

Response body

object

sku

string

required

A selling partner provided identifier for an Amazon listing.

status

string

required

The status of the listings item submission.

ACCEPTED INVALID

Show Details

ACCEPTED	The listings submission was accepted for processing.
INVALID	The listings submission was not valid and was not accepted for processing.

submissionId

string

required

The unique identifier of the listings item submission.

issues

array of objects

Listings item issues related to the listings item submission.

issues

object

code

string

required

An issue code that identifies the type of issue.

message

string

required

A message that describes the issue.

severity

string

required

The severity of the issue.

ERROR WARNING INFO

Show Details

ERROR	Indicates an issue has occurred preventing the submission from processing, such as a validation error.
WARNING	Indicates an issue has occurred that should be reviewed, but has not prevented the submission from processing.
INFO	Indicates additional information has been provided that should be reviewed.

attributeName

string

Name of the attribute associated with the issue, if applicable.

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Language


xxxxxxxxxx
1
curl --request DELETE \
2
     --url https://sellingpartnerapi-na.amazon.com/listings/2020-09-01/items/sellerId/sku \
3
     --header 'accept: application/json'


xxxxxxxxxx
 
1
{
2
  "sku": "GM-ZDPI-9B4E",
3
  "status": "ACCEPTED",
4
  "submissionId": "f1dc2914-75dd-11ea-bc55-0242ac130003",
5
  "issues": []
6
}

200Successfully understood the listings item delete request. See the response to determine whether the submission has been accepted.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.