PUT listings/update-prices

This call allows you to update the prices of Listings by either SKU, Listing ID or Channel Identifier. A successful update of price will trigger price update on the channel if it is enabled in the channel settings. You can only update a maximum of 50 Listings at once.

Request Information

URI Parameters

None.

Body Parameters

Collection of ListingPriceUpdateModel
NameDescriptionTypeAdditional information
ListingIDType The type of Listing identifier passed ListingIDTypeModel None.
ChannelID The ID of Listing's Channel integer Required Matching regular expression pattern: ^[1-9]\d*$
Price New price of the Listing decimal number Required

Request Formats

application/json, text/json

Sample:
[
  {
    "ListingIDType": {
      "IDType": "SKU",
      "Value": "SKU-1"
    },
    "ChannelID": 1234,
    "Price": 9.99
  },
  {
    "ListingIDType": {
      "IDType": "ID",
      "Value": "5467"
    },
    "ChannelID": 12,
    "Price": 19.99
  },
  {
    "ListingIDType": {
      "IDType": "ChannelIdentifier",
      "Value": "1234567890"
    },
    "ChannelID": 15,
    "Price": 1.99
  }
]

application/xml, text/xml

Sample:
<ArrayOfListingPriceUpdateModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ListingPriceUpdateModel>
    <ListingIDType>
      <IDType>SKU</IDType>
      <Value>SKU-1</Value>
    </ListingIDType>
    <ChannelID>1234</ChannelID>
    <Price>9.99</Price>
  </ListingPriceUpdateModel>
  <ListingPriceUpdateModel>
    <ListingIDType>
      <IDType>ID</IDType>
      <Value>5467</Value>
    </ListingIDType>
    <ChannelID>12</ChannelID>
    <Price>19.99</Price>
  </ListingPriceUpdateModel>
  <ListingPriceUpdateModel>
    <ListingIDType>
      <IDType>ChannelIdentifier</IDType>
      <Value>1234567890</Value>
    </ListingIDType>
    <ChannelID>15</ChannelID>
    <Price>1.99</Price>
  </ListingPriceUpdateModel>
</ArrayOfListingPriceUpdateModel>

Response Information

Resource Description

This call allows you to update the prices of Listings by either SKU, Listing ID or Channel Identifier. A successful update of price will trigger price update on the channel if it is enabled in the channel settings. You can only update a maximum of 50 Listings at once.

ListingPriceUpdateModelCollectionResponse
NameDescriptionTypeAdditional information
TotalItemsProcessed integer None.
Successful integer None.
Failed integer None.
Responses Collection of ListingPriceUpdateModelResponse None.

Response Formats

application/json, text/json

Sample:
{
  "TotalItemsProcessed": 3,
  "Successful": 2,
  "Failed": 1,
  "Responses": [
    {
      "Update": {
        "ListingIDType": {
          "IDType": "SKU",
          "Value": "SKU-1"
        },
        "ChannelID": 1234,
        "Price": 9.99
      },
      "Success": false,
      "Error": "Listing doesn't exist or you do not have permission to access it."
    },
    {
      "Update": {
        "ListingIDType": {
          "IDType": "ID",
          "Value": "5467"
        },
        "ChannelID": 12,
        "Price": 19.99
      },
      "Success": true
    },
    {
      "Update": {
        "ListingIDType": {
          "IDType": "ChannelIdentifier",
          "Value": "1234567890"
        },
        "ChannelID": 15,
        "Price": 1.99
      },
      "Success": true
    }
  ]
}