getItemOffersBatch

post https://sellingpartnerapi-na.amazon.com/batches/products/pricing/v0/itemOffers

Returns the lowest priced offers for a batch of items based on ASIN.

Usage Plan:

Rate (requests per second)	Burst
0.1	1

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.

Body Params

The request associated with the getItemOffersBatch API call.

requests

array of objects

length between 1 and 20

A list of getListingOffers batched requests to run.

requests

uri

string

required

The resource path of the operation you are calling in batch without any query parameters.

If you are calling getItemOffersBatch, supply the path of getItemOffers.

Example: /products/pricing/v0/items/B000P6Q7MY/offers

If you are calling getListingOffersBatch, supply the path of getListingOffers.

Example: /products/pricing/v0/listings/B000P6Q7MY/offers

method

string

required

The HTTP method associated with the individual APIs being called as part of the batch request.

Show Details

GET	GET
PUT	PUT
PATCH	PATCH
DELETE	DELETE
POST	POST

headers

object

A mapping of additional HTTP headers to send/receive for the individual batch request.

MarketplaceId

string

required

A marketplace identifier. Specifies the marketplace for which prices are returned.

ItemCondition

string

required

Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

Show Details

New	New
Used	Used
Collectible	Collectible
Refurbished	Refurbished
Club	Club

CustomerType

string

Indicates whether to request Consumer or Business offers. Default is Consumer.

Show Details

Consumer	Consumer
Business	Business

200

Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded.

400

Request has missing or invalid parameters and cannot be parsed.

401

The request's Authorization header is not formatted correctly or does not contain a valid token.

403

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

404

The specified resource does not exist.

429

The frequency of requests was greater than allowed.

500

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

503

Temporary overloading or maintenance of the server.

xxxxxxxxxx
curl --request POST \
     --url https://sellingpartnerapi-na.amazon.com/batches/products/pricing/v0/itemOffers \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "requests": [
    {
      "method": "GET",
      "ItemCondition": "New",
      "CustomerType": "Consumer"
    }
  ]
}
'

xxxxxxxxxx
}
{
  "responses": [
    {
      "headers": {
        "Date": "string",
        "x-amzn-RequestId": "string",
        "additionalProp": "string"
      },
      "status": {
        "statusCode": 0,
        "reasonPhrase": "string"
      },
      "body": {
        "payload": {
          "MarketplaceID": "string",
          "ASIN": "string",
          "SKU": "string",
          "ItemCondition": "New",
          "status": "string",
          "Identifier": {
            "MarketplaceId": "string",
            "ASIN": "string",
            "SellerSKU": "string",
            "ItemCondition": "New"
          },

responses

Has additional fields

status

The HTTP status line associated with the response. For more information, consult RFC 2616.

body

The response schema for the getListingOffers and getItemOffers operations.

request

Common request parameters that can be accepted by ItemOffersRequest and ListingOffersRequest

200Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded.

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

401The request's Authorization header is not formatted correctly or does not contain a valid token.

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

404The specified resource does not exist.

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.