---
title: "Return details about a specific delivery"
method: GET
path: "/ws/shipping/v1/deliveries/{id}"
tags: ["Backship"]
---

# Return details about a specific delivery

`GET /ws/shipping/v1/deliveries/{id}`

## Request

- Base URL: `https://preprod.backmarket.co.jp`
- URL: `https://preprod.backmarket.co.jp/ws/shipping/v1/deliveries/{id}`
- 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/:id/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.

## Path parameters

- `id` integer, required

## Response `200`

Delivery details

- Delivery
  - `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

- `404`: Delivery entry not found

## 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/:id/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)