---
title: "Get listing details"
method: GET
path: "/ws/listings/detail"
tags: ["Listings"]
---

# Get listing details

`GET /ws/listings/detail`

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/`

## Response `200`

OK

- object
  - `backmarket_id` integer, required — Deprecated product ID. Please use the UUID format, see field 'product_id'.
  - `comment` string, nullable, required — Comment. Maximum 500 characters.
  - `currency` string, required — Currency of 'price'
  - `id` string, uuid, required — Listing ID
  - `listing_id` integer, required — Listing ID (deprecated). Please use the UUID format, see field 'id'.
  - `max_price` string, required — Maximum allowed price for this listing, or it will not be online.
  - `min_price` string, nullable, required — Minimum acceptable price for the Backpricer.
  - `price` string, required — Price of the listing in the 'currency'
  - `product_id` string, uuid, required — Product ID
  - `publication_state` 0 | 1 | 2 | 3 | 4, required
  - `quantity` integer, required — Available stock.
  - `shippings` object[], required — Shippings defined at listing level (if any). Does not include shippings defined at category level nor the global ones.
    - `country_code` string, required — The market where this shipping option is available. Passed as the language code of this market.
    - `shipper` string, required — The company that manages the delivery.
    - `shipper_display` string, required — The company that manages the delivery.
    - `shipping_delay` integer, required — Expected shipping delay in hours.
    - `shipping_price` string, required — Price of the shipping option, using currency of listing.
  - `sku` string, required — SKU provided by the seller on listing creation.
  - `state` 9 | 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.
  - `title` string, required — Product title
  - `warranty_delay` integer, required — Warranty period in months (12 months minimum).
  - `new_battery` boolean — 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.
  - `statuscode` integer, required

## Other responses

- `400` — Invalid inputs (bad type…).
- `401` — Unauthenticated.
- `403` — Forbidden. Authenticated user is not a merchant.
- `404` — Listing not found, or it does not belong to the authenticated merchant.

---

[API](https://skmtc.net/backmarket/apis/back-market-api-guidelines.md) · [All operations](https://skmtc.net/backmarket/apis/back-market-api-guidelines/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/backmarket/back-market-api-guidelines/revisions/6a1303364143/schema)