---
title: "Return backbox data per listing list"
method: GET
path: "/ws/listings_bi"
tags: ["Backbox"]
---

# Return backbox data per listing list

`GET /ws/listings_bi`

Get the Backbox data related to your competitors, i.e. your online listings competing in a Backbox. You can call this endpoint twice every hour for each country.

Backbox (previously named Buybox) is the listing displayed at a given time on the website when it has the best ratio quality score per price.

This endpoint is being deprecated in favor of the /ws/backbox/v1/competitors endpoint.

## Query parameters

- `page` integer
- `page-size` integer

## Response `200`

List of backbox data per listing

- object
  - `count` integer, required — Total number of backbox data per listing
  - `next` string, nullable, required — URL to get the next paginated backbox data per listing list. Null if no next page
  - `previous` string, nullable, required — URL to get the previous paginated backbox data per listing list. Null if no previous page
  - `results` Backbox[], required — List of backbox data per listing
    - `product` integer, required — Product ID
    - `sku` string, required — SKU used to match to an existing listing (also a listing's unique Id)
    - `price` number, required — Listing price
    - `quantity` integer, required — Stock available
    - `buybox` boolean, required — Does this listing have Backbox
    - `price_for_buybox` number, required — If your listing does not have Backbox, the price you will have to set to have it (aka red price)
    - `currency` string — Currency of the listing, it will depend on the market ("GBP" for UK for instance)
    - `condition` 9 | 10 | 11 | 12, required — Condition of the product. | Value | Description | |-------|---------------------| | 9 | Premium condition | | 1O | Excellent condition | | 11 | Good condition | | 12 | Fair condition |
    - `same_merchant_winner` boolean, required — Does one of your listing have Backbox

## Other responses

- `403` — Permission denied
- `404` — Webservices unavailable
- `429` — Too many calls

---

[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)