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

# Get listing details

`GET /ws/listings/detail`

## Request

- Base URL: `https://preprod.backmarket.co.jp`
- URL: `https://preprod.backmarket.co.jp/ws/listings/detail`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP basic
- TypeScript: <https://skmtc.dev/backmarket/apis/back-market-api-guidelines/docs/ws/listings/detail/get.ts> (a function with typed inputs; its response is checked against the schema)

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.
  - `outlet` boolean: The listing is an outlet product. Values (case-insensitive): “true” if it is an outlet, else “false”. Seller must be eligible to sell outlet products 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.

## Changes

- **2026-09-11** `92bbdc78f1fc`: 1 info
  - added the optional property `allOf[#/components/schemas/ListingPublic]/outlet` to the response with the `200` status
- **2026-08-08** `e148c36fefb6`: 1 info
  - added the optional property `allOf[#/components/schemas/ListingPublic]/new_battery` to the response with the `200` status

[Operation history](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/changes/ws/listings/detail/get.md)

---

[API](https://skmtc.dev/backmarket/apis/back-market-api-guidelines.md) - [All operations](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/llms.txt) - [OpenAPI document](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/revisions/30a7402bb310?raw)