---
title: "Retrieve a BuyBack order"
method: GET
path: "/ws/buyback/v1/orders/{buybackOrderId}"
tags: ["BuyBack"]
---

# Retrieve a BuyBack order

`GET /ws/buyback/v1/orders/{buybackOrderId}`

## Request

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

Retrieve a single BuyBack order.
Caller must be an authenticated merchant.

## Path parameters

- `buybackOrderId` string, required

## Response `200`

OK

- BuybackOrder: Buyback order sent back by 'ws/buyback/' endpoints
  - `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
- `404`: Not Found
- `5XX`: Internal Error

---

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