---
title: "Return deliveries list"
method: GET
path: "/ws/shipping/v1/deliveries"
tags: ["Backship"]
---

# Return deliveries list

`GET /ws/shipping/v1/deliveries`

## Request

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

This API is for merchants who are subscribed to the BackShip service.

Once an orderline has been accepted via the Orderline API, a shipping label is automatically created corresponding
to this orderline and can be retrieved from this endpoint via the field `labelUrl`.
The state of the orderline must be updated once the product has been shipped.

## Query parameters

- `page` integer
- `order_id` integer
- `start_date` string, date-time
- `end_date` string, date-time
- `pickup_start_date` string, date-time
- `pickup_end_date` string, date-time
- `order_state` 0 | 1 | 3 | 8 | 9
- `hub_scanned` boolean

## Response `200`

List of deliveries

- object
  - `count` integer, required: Total number of deliveries
  - `next` string, nullable, required: Url to get the next paginated deliveries list. Null if no next page
  - `previous` string, nullable, required: Url to get the previous paginated deliveries list. Null if no previous page
  - `results` Delivery[], required: List of deliveries
    - `order` integer, required: Order ID
    - `shipmentId` integer, required: Shipment ID
    - `carrierId` integer, required: Carrier ID
    - `orderlines` integer[], required: Orderlines
    - `referenceNumber` string, required: Reference number
    - `trackingNumber` string, required: Tracking number
    - `trackingUrl` string, required: Tracking url
    - `carrierName` string, required: Carrier name
    - `hubScanned` boolean, required: Whether the related shipment label have been scanned
    - `invoicedCurrency` string, required: Invoice currency
    - `invoicedPrice` integer, required: Invoiced amount
    - `datePickup` string, date-time, required: Pickup date
    - `dateCreation` string, date-time, required: Creation date
    - `dateDelivery` string, date-time, required: Delivery date
    - `labelUrl` string, required: Label url
    - `type` string, required: Type of delivery
    - `pickupInfo` PickupInfo, required
      - `confirmationNumber` string, required: Confirmation number
      - `datePickupActual` string, required: Actual pickup date
      - `datePickupRangeStart` string, required: Start date of pickup
      - `datePickupRangeEnd` string, required: End date of pickup
      - `datePickupRequested` string, required: Requested date for pickup
      - `isCanceled` boolean, required: Pickup cancellation state
      - `pickupId` integer, required: Pickup ID

## Other responses

- `422`: Unprocessable Entity

## Changes

- **2026-08-08** `e148c36fefb6`: 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BasicAuth` was added to the API

[Operation history](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/changes/ws/shipping/v1/deliveries/get.md)

---

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