---
title: "List of BuyBack orders"
method: GET
path: "/ws/buyback/v1/orders"
tags: ["BuyBack"]
---

# List of BuyBack orders

`GET /ws/buyback/v1/orders`

List of paginated buyback orders.
Caller must be an authenticated merchant.

## Query parameters

- `status` 'NEW' | 'PENDING' | 'TO_SEND' | 'SENT' | 'RECEIVED' | 'COUNTER_PROPOSAL' | 'VALIDATED' | 'PAID' | 'MONEY_TRANSFERED' | 'SUSPENDED' — Buyback order state
- `productId` integer
- `creationDate` string, datetime
- `modificationDate` string, datetime
- `shippingDate` string, datetime
- `receivedDate` string, datetime
- `suspendedDate` string, datetime
- `paymentDate` string, datetime
- `page` integer

## Response `200`

OK

- object
  - `count` number, required — Total number of objects or items
  - `next` string, nullable, required — URL pointing to the next page
  - `previous` string, nullable, required — URL pointing to the previous page
  - `results` BuybackOrder[]
    - `orderPublicId` string, required — buyback order public identifier
    - `creationDate` string, required — Buyback Order creation date
    - `modificationDate` string, required — Buyback Order last modification date
    - `shippingDate` string, required — Buyback Order shipping date
    - `suspensionDate` string — Buyback Order suspension date
    - `receivalDate` string — Buyback Order reception date
    - `paymentDate` string — Buyback Order payment date
    - `counterProposalDate` string — Last counter proposal date
    - `status` 'NEW' | 'PENDING' | 'TO_SEND' | 'SENT' | 'RECEIVED' | 'COUNTER_PROPOSAL' | 'VALIDATED' | 'PAID' | 'MONEY_TRANSFERED' | 'SUSPENDED', required — Buyback order state
    - `market` string, required — Idenfitication code of the market in which the buyback order was placed
    - `transferCertificateLink` string, required — URL where the transfer certificate can be downloaded
    - `listing` object, required
      - `sku` string — (Stock-keeping unit) Identification number of the product
      - `productId` number, required — Identification number of the product bought back by the merchant
      - `title` string, required — Name of the product bought back by the merchant
      - `grade` 'DIAMOND' | 'PLATINUM' | 'GOLD' | 'SILVER' | 'BRONZE' | 'STALLONE', required — Quality grade of the buyback order
    - `customer` object, required
      - `firstName` string — First name of the customer who wants to sell a device
      - `lastName` string — Last name of the customer who wants to sell a device
      - `phone` string — Phone number of the customer
      - `dateOfBirth` string — Birthdate of the customer
      - `documents` object[]
        - `type` 'PASSPORT' | 'ID' | 'ID_CARD_FRONT' | 'ID_CARD_BACK' | 'BANK_STATEMENT' | 'DRIVING_LICENCE_FRONT' | 'DRIVING_LICENCE_BACK', required — Type of the KYC document
        - `url` string, required — URL where the document can be downloaded
    - `returnAddress` object, required — Address where the parcel can be returned
      - `address1` string — Main address description
      - `address2` string — Details on the address
      - `city` string — City of the address
      - `zipcode` string — Zipcode of the address
      - `country` string, required — Country of the address
    - `originalPrice` object, required — Initial offer price
      - `value` number, required — Initial offer amount
      - `currency` string, required — Initial price currency
    - `counterOfferPrice` object — Counter offer price set by the merchant
      - `value` number, required — Amount set by the merchant
      - `currency` string, required — Currency of the counter offer price set by the merchant
    - `trackingNumber` string — Tracking number of the parcel
    - `shipper` string — Shipper of the parcel
    - `suspendReasons` BuybackReason[] — List of reasons set by the merchant when putting the buyback order on hold
      - `message` string, required — Details of the reason
      - `identifier` string, required — Identifier of the reason
      - `category` string — Category of the reason
    - `counterOfferReasons` BuybackReason[] — List of reasons set by the merchant when making a counter offer on the buyback order
      - `message` string, required — Details of the reason
      - `identifier` string, required — Identifier of the reason
      - `category` string — Category of the reason

## Other responses

- `401` — Unauthorized
- `403` — Permission denied

---

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