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

# Get listings

`GET /ws/listings`

Retrieve all your `Listings`.

## Query parameters

- `publication_state` 0 | 1 | 2 | 3 | 4
- `min_quantity` integer
- `max_quantity` integer
- `page` integer
- `page-size` integer

## Headers

- `Accept-Language` string

## Response `200`

OK

- object
  - `count` integer, required
  - `next` string, nullable, required
  - `previous` string, nullable, required
  - `results` ListingPublic[], required
    - `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.

## Other responses

- `401` — Unauthenticated.
- `403` — Forbidden. Authenticated user is not a 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)