Sign in
BuyBack

List of BuyBack orders

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

get/ws/buyback/v1/orders

Query parameters

status'NEW' | 'PENDING' | 'TO_SEND' | 'SENT' | 'RECEIVED' | 'COUNTER_PROPOSAL' | 'VALIDATED' | 'PAID' | 'MONEY_TRANSFERED' | 'SUSPENDED'

Buyback order state

Example:TO_SEND

Buyback Order status

productIdinteger

BuyBack product ID

creationDatestring datetime

BuyBack order minimum creation date

modificationDatestring datetime

BuyBack order minimum modification date

shippingDatestring datetime

BuyBack order minimum shipping date

receivedDatestring datetime

BuyBack order minimum received date

suspendedDatestring datetime

BuyBack order minimum suspended date

paymentDatestring datetime

BuyBack order minimum payment date

pageinteger

Page number

Response

OK

countnumber required

Total number of objects or items

nextstring nullable required

URL pointing to the next page

previousstring nullable required

URL pointing to the previous page

Example response

{
  "count": 133,
  "next": "https://www.backmarket.fr/ws/buyback/v1/orders?page=3",
  "previous": "https://www.backmarket.fr/ws/buyback/v1/orders?page=1",
  "results": [
    {
      "orderPublicId": "US-24527-ABCDE",
      "creationDate": "2019-03-21T14:28:30+01:00",
      "modificationDate": "2019-03-26T08:00:53+01:00",
      "shippingDate": "2019-03-21T14:37:54+01:00",
      "suspensionDate": "2019-03-21T14:37:54+01:00",
      "receivalDate": "2019-03-21T14:37:54+01:00",
      "paymentDate": "2019-03-21T14:38:11+01:00",
      "counterProposalDate": "2019-03-21T14:37:54+01:00",
      "status": "TO_SEND",
      "market": "FR",
      "transferCertificateLink": "https://tranfer-certificate.com",
      "listing": {
        "sku": "21000021",
        "productId": 2311,
        "title": "Apple iPhone XS 64 Go",
        "grade": "DIAMOND"
      },
      "customer": {
        "firstName": "John",
        "lastName": "Doe",
        "phone": "+33699887766",
        "dateOfBirth": "1970-03-21",
        "documents": [
          {
            "type": "PASSPORT",
            "url": "https://bucket.com/user_document/passport.jpeg"
          }
        ]
      },
      "returnAddress": {
        "address1": "10, Downing street",
        "address2": "3rd floor",
        "city": "London",
        "zipcode": "93100",
        "country": "United Kingdom"
      },
      "originalPrice": {
        "value": 1000,
        "currency": "EUR"
      },
      "counterOfferPrice": {
        "value": 900,
        "currency": "EUR"
      },
      "trackingNumber": "8R41352499203",
      "shipper": "DHL",
      "suspendReasons": [
        {
          "message": "Empty parcel",
          "identifier": "parcel_empty",
          "category": "Transport issue"
        }
      ],
      "counterOfferReasons": [
        {
          "message": "Empty parcel",
          "identifier": "parcel_empty",
          "category": "Transport issue"
        }
      ]
    }
  ]
}