Sign in
Listings

Update specific listing

It is possible to update some fields of a specific Listing. For example you might want to add another country to the Listing. You might also need to change the price, comment or the available stock (quantity).

To put a Listing offline, just set its quantity to 0.

The endpoint below provides the most efficient way to update a specific Listing, as the update will be taken into account in real-time. Yet, you can only update one Listing at a time on this endpoint as opposed to the endpoint to update several listings.

If you work with other marketplaces, DO NOT forget to update your stocks on Back Market in order not to be compelled to cancel orders. We strongly penalize high cancellation rates in our algorithm, which allocates Backbox.

Updating in real time is especially important when your stock for the listing is close to 0.

When an order is made on Back Market, you don't need to decrease the stock in our database since we decrease it automatically.

You just need to specify field(s) you would like to change. All the others will be kept intact.

post/ws/listings/{listingId}

Request body

currencystring

Currency of 'price' in ISO 4217 code format. If 'price' is in the request, this field must match the currency of the market selected with the 'Accept-Language' header. Defaults to EUR for the EU marketplace, USD for the US one. Thus this field is required for markets where the currency is not these defaults.

commentstring nullable

Comment. Maximum 500 characters.

shipper_1'Allied Express' | 'Aramex Australia' | 'Australia Post' | 'Australia Post Express' | 'Austrian Post' | 'BPost' | 'BRT' | 'Chronopost' | 'Chronopost Express' | 'ColisPrivé' | 'Colissimo' | 'Correos' | 'Correos Express' | 'Couriers Please' | 'CTT' | 'Cubyn' | 'Cubyn Express' | 'DB Schenker' | 'Deutsche Post' | 'DHL' | 'DHL DE' | 'DHL Express' | 'DHL EXPRESS' | 'DHL NL' | 'DHL Parcel Spain' | 'DHL SP' | 'DPD' | 'DPD Benelux' | 'DPD DE' | 'DPD FR' | 'DPD International' | 'DPD UK' | 'DPD UK Express' | 'DTDC Australia' | 'FedEx' | 'FedEx - 2Days' | 'FedEx Express' | 'FedEx International' | 'FedEx - Overnight' | 'Geodis' | 'Girard Agediss - Livraison dans la pièce de votre choix sur RDV' | 'GLS' | 'GLS - DE' | 'GLS - FR' | 'GLS International' | 'GLS - IT' | 'GLS-SPAIN' | 'GLS Spain Express' | 'Hermes - DE' | 'Hermes - UK' | 'Japan Post' | 'Livraison au pied du camion' | 'Livraison dans la pièce de votre choix' | 'Logoix' | 'MRW' | 'Murfy transporteur' | 'NACEX' | 'ParcelForce Express' | 'Parcelforce (Worldwide)' | 'Parcelpoint Pty Ltd' | 'Poste Italiane' | 'Post NL' | 'Private Transporter' | 'Royal Mail' | 'Royal Mail Express' | 'Sagawa' | 'Seino' | 'Sendle' | 'Seur' | 'Socolissimo' | 'Star Track Express' | 'TIPSA' | 'TIPSA Express' | 'TNT' | 'TNT Australia' | 'TNT Express' | 'Tourline' | 'UPS' | 'UPS 2 days' | 'UPS 2nd Day Air' | 'UPS Express' | 'UPS express save' | 'UPS Ground' | 'UPS next day' | 'UPS Overnight' | 'UPS standard' | 'USPS' | 'USPS Express' | 'USPS - First Class' | 'USPS - Priority Mail' | 'USPS - Priority Mail Express' | 'VIR' | 'Yamato' | 'Zeleris' | 'Other' nullable

Name of the shipper, the company that manages the delivery. Some shippers may not be available in all countries. Call us to add your shipper.

shipper_display_1string nullable

The displayed name for the shipper.

shipping_delay_1integer nullable

Expected shipping delay in hours.

shipper_2'Allied Express' | 'Aramex Australia' | 'Australia Post' | 'Australia Post Express' | 'Austrian Post' | 'BPost' | 'BRT' | 'Chronopost' | 'Chronopost Express' | 'ColisPrivé' | 'Colissimo' | 'Correos' | 'Correos Express' | 'Couriers Please' | 'CTT' | 'Cubyn' | 'Cubyn Express' | 'DB Schenker' | 'Deutsche Post' | 'DHL' | 'DHL DE' | 'DHL Express' | 'DHL EXPRESS' | 'DHL NL' | 'DHL Parcel Spain' | 'DHL SP' | 'DPD' | 'DPD Benelux' | 'DPD DE' | 'DPD FR' | 'DPD International' | 'DPD UK' | 'DPD UK Express' | 'DTDC Australia' | 'FedEx' | 'FedEx - 2Days' | 'FedEx Express' | 'FedEx International' | 'FedEx - Overnight' | 'Geodis' | 'Girard Agediss - Livraison dans la pièce de votre choix sur RDV' | 'GLS' | 'GLS - DE' | 'GLS - FR' | 'GLS International' | 'GLS - IT' | 'GLS-SPAIN' | 'GLS Spain Express' | 'Hermes - DE' | 'Hermes - UK' | 'Japan Post' | 'Livraison au pied du camion' | 'Livraison dans la pièce de votre choix' | 'Logoix' | 'MRW' | 'Murfy transporteur' | 'NACEX' | 'ParcelForce Express' | 'Parcelforce (Worldwide)' | 'Parcelpoint Pty Ltd' | 'Poste Italiane' | 'Post NL' | 'Private Transporter' | 'Royal Mail' | 'Royal Mail Express' | 'Sagawa' | 'Seino' | 'Sendle' | 'Seur' | 'Socolissimo' | 'Star Track Express' | 'TIPSA' | 'TIPSA Express' | 'TNT' | 'TNT Australia' | 'TNT Express' | 'Tourline' | 'UPS' | 'UPS 2 days' | 'UPS 2nd Day Air' | 'UPS Express' | 'UPS express save' | 'UPS Ground' | 'UPS next day' | 'UPS Overnight' | 'UPS standard' | 'USPS' | 'USPS Express' | 'USPS - First Class' | 'USPS - Priority Mail' | 'USPS - Priority Mail Express' | 'VIR' | 'Yamato' | 'Zeleris' | 'Other' nullable

Name of the shipper, the company that manages the delivery. Some shippers may not be available in all countries. Call us to add your shipper.

shipper_display_2string nullable

The displayed name for the shipper.

shipping_delay_2integer nullable

Expected shipping delay in hours.

shipper_3'Allied Express' | 'Aramex Australia' | 'Australia Post' | 'Australia Post Express' | 'Austrian Post' | 'BPost' | 'BRT' | 'Chronopost' | 'Chronopost Express' | 'ColisPrivé' | 'Colissimo' | 'Correos' | 'Correos Express' | 'Couriers Please' | 'CTT' | 'Cubyn' | 'Cubyn Express' | 'DB Schenker' | 'Deutsche Post' | 'DHL' | 'DHL DE' | 'DHL Express' | 'DHL EXPRESS' | 'DHL NL' | 'DHL Parcel Spain' | 'DHL SP' | 'DPD' | 'DPD Benelux' | 'DPD DE' | 'DPD FR' | 'DPD International' | 'DPD UK' | 'DPD UK Express' | 'DTDC Australia' | 'FedEx' | 'FedEx - 2Days' | 'FedEx Express' | 'FedEx International' | 'FedEx - Overnight' | 'Geodis' | 'Girard Agediss - Livraison dans la pièce de votre choix sur RDV' | 'GLS' | 'GLS - DE' | 'GLS - FR' | 'GLS International' | 'GLS - IT' | 'GLS-SPAIN' | 'GLS Spain Express' | 'Hermes - DE' | 'Hermes - UK' | 'Japan Post' | 'Livraison au pied du camion' | 'Livraison dans la pièce de votre choix' | 'Logoix' | 'MRW' | 'Murfy transporteur' | 'NACEX' | 'ParcelForce Express' | 'Parcelforce (Worldwide)' | 'Parcelpoint Pty Ltd' | 'Poste Italiane' | 'Post NL' | 'Private Transporter' | 'Royal Mail' | 'Royal Mail Express' | 'Sagawa' | 'Seino' | 'Sendle' | 'Seur' | 'Socolissimo' | 'Star Track Express' | 'TIPSA' | 'TIPSA Express' | 'TNT' | 'TNT Australia' | 'TNT Express' | 'Tourline' | 'UPS' | 'UPS 2 days' | 'UPS 2nd Day Air' | 'UPS Express' | 'UPS express save' | 'UPS Ground' | 'UPS next day' | 'UPS Overnight' | 'UPS standard' | 'USPS' | 'USPS Express' | 'USPS - First Class' | 'USPS - Priority Mail' | 'USPS - Priority Mail Express' | 'VIR' | 'Yamato' | 'Zeleris' | 'Other' nullable

Name of the shipper, the company that manages the delivery. Some shippers may not be available in all countries. Call us to add your shipper.

shipper_display_3string nullable

The displayed name for the shipper.

shipping_delay_3integer nullable

Expected shipping delay in hours.

Example request

{
  "price": "160.99",
  "currency": "EUR",
  "comment": "This is an iPhone 6S - 64Go - Blue working with all operators",
  "warranty_delay": 24,
  "quantity": 12,
  "shipper_1": "DHL Express",
  "shipper_display_1": "DHL Express",
  "shipping_delay_1": 36,
  "shipping_price_1": "3.90",
  "shipper_2": "DHL Express",
  "shipper_display_2": "DHL Express",
  "shipping_delay_2": 36,
  "shipping_price_2": "3.90",
  "shipper_3": "DHL Express",
  "shipper_display_3": "DHL Express",
  "shipping_delay_3": 36,
  "shipping_price_3": "3.90",
  "min_price": "160.99"
}

Response

OK. Update processed. Note that some processing can be done asynchronously (Backbox, search indexing, etc).

idstring uuid required

Listing ID

listing_idinteger required

Listing ID (deprecated)

product_idstring uuid

Product ID

backmarket_idinteger required

Product ID (deprecated)

titlestring required

Product title

state9 | 0 | 1 | 2 | 3 | 4 required

Deprecated, please use the "grade" field. Aethestic grade. Values: 9 (Premium), 0 (Excellent), 1 (Very good), 2 (Good), 3 (Fair), 4 (Stallone)

grade'PREMIUM' | 'EXCELLENT' | 'VERY_GOOD' | 'GOOD' | 'FAIR' | 'STALLONE' required

Aethestic grade.

quantityinteger required

Available stock.

currencystring required

Currency of 'price'

skustring required

SKU provided by the seller on listing creation.

publication_state0 | 1 | 2 | 3 | 4 required
warranty_delayinteger required

Warranty period in months (12 months minimum).

pricestring required

Price of the listing in the 'currency'

commentstring nullable required

Comment. Maximum 500 characters.

max_pricestring required

Maximum allowed price for this listing, or it will not be online.

shippings_responsestring[]

Success and failure messages related to processing of shippings data.

statuscodeinteger required
min_pricestring nullable required

Minimum acceptable price for the Backpricer.

Example response

{
  "id": "7a97a1b6-547e-4718-bc72-5b84aca91b09",
  "listing_id": 4567,
  "product_id": "6d4ad966-db97-4d88-b409-b28cc2a0f8c9",
  "backmarket_id": 42,
  "title": "iPhone 6S - 64Go - Blue - Unlocked",
  "shippings": [
    {
      "shipping_price": "0.00",
      "shipping_delay": 24,
      "shipper": "UPS",
      "shipper_display": "UPS",
      "country_code": "it-it"
    }
  ],
  "state": 4,
  "grade": "EXCELLENT",
  "quantity": 12,
  "currency": "EUR",
  "sku": "IPHONE_6S_64GO_BLUE_CORRECT",
  "publication_state": 2,
  "warranty_delay": 24,
  "price": "160.99",
  "comment": "This is an iPhone 6S - 64Go - Blue working with all operators",
  "max_price": "199.90",
  "shippings_response": [
    "Shipping method 2 (ACME Company) updated"
  ],
  "statuscode": 200,
  "min_price": "160.99"
}