Sign in
latestOpenAPI 3.0.32026-08-193973220.1 KB

6a1303364143

Listings

Get specific listing

Retrieve a specific Listing to check its information.

Endpoint

The 2 following endpoints provide exactly the same response:

<aside class="success"> HTTP GET request: https://www.backmarket.fr/ws/listings/LISTING_ID </aside>

Or working with a filter on:

<aside class="success"> HTTP GET request: https://www.backmarket.fr/ws/listings/detail/ </aside>

If you don't have either the sku nor the listing_id, you can retrieve them by:

GET https://www.backmarket.fr/ws/listings/

get/ws/listings/{listingId}

Response

OK

backmarket_idinteger required

Deprecated product ID. Please use the UUID format, see field 'product_id'.

commentstring nullable required

Comment. Maximum 500 characters.

currencystring required

Currency of 'price'

idstring uuid required

Listing ID

listing_idinteger required

Listing ID (deprecated). Please use the UUID format, see field 'id'.

max_pricestring required

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

min_pricestring nullable required

Minimum acceptable price for the Backpricer.

pricestring required

Price of the listing in the 'currency'

product_idstring uuid required

Product ID

publication_state0 | 1 | 2 | 3 | 4 required
quantityinteger required

Available stock.

skustring required

SKU provided by the seller on listing creation.

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.

titlestring required

Product title

warranty_delayinteger required

Warranty period in months (12 months minimum).

new_batteryboolean

The device has a new battery. Values (case-insensitive): “true” if the device has a new battery, else “false”. Seller must be eligible to sell new battery devices to be able to list such listings.

statuscodeinteger required

Example response

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