---
title: "Get shipments"
method: GET
path: "/orders/{orderId}/shipments"
tags: ["Orders"]
---

# Get shipments

`GET /orders/{orderId}/shipments`

get a list with all shipments for this order

## Path parameters

- `orderId` integer, required

## Response `200`

OK

- Shipment[]
  - `id` integer — shipment id
  - `orderId` integer — spreadconnect order id
  - `orderReference` integer — order reference from spreadconnect, can be changed after order updates
  - `externalOrderReference` string — external order reference from merchant (you)
  - `orderItemReferences` integer[] — spreadconnect order item references
  - `externalOrderItemReferences` string[] — external order item references
  - `shipping` object — shipment shipping information
    - `address` Address — physical mailing address
      - `company` string — company name
      - `firstName` string — first name
      - `lastName` string, required — last name
      - `street` string, required — street. Must not be blank.
      - `streetAnnex` string — street annex, optional
      - `city` string, required — city name. Must not be blank.
      - `country` string, required — country code, is the ISO 3166-1 alpha-2 code of the country to deliver to, e.g. 'DE' or 'US'.
      - `state` string — state code, is the country-specific 2-letter upper-case, e.g. AL for Alabama in the USA This field is required when delivering to the USA or Canada
      - `zipCode` string, required — zip code, for some countries optional
    - `type` ShippingType — shipping type with id, name and description
      - `id` string — shipping type id, needed for set shipping type
      - `company` string — shipping company such as DHL, UPS, DPD, USPS, DHL Express, FedEx, Post AT, Deutsche Post
      - `name` string
      - `description` string
    - `price` Price — price
      - `amount` number, required — total amount, with vat or sales tax. Must be zero or greater.
      - `taxRate` number — included vat rate in percent, only for tax type VAT
      - `taxAmount` number — included sales tax, only for tax type SALETAX
      - `currency` string, required — currency iso code (ISO 4217, 3 letters)
  - `tracking` object[] — tracking information for shipment
    - `code` string — tracking code
    - `url` string — tracking url
  - `closedDate` string — ready for shipment date
  - `sentDate` string — sent date

## Other responses

- `404` — Order not found

---

[API](https://skmtc.net/spreadconnect/apis/spreadconnect-fulfillment-service-rest-api.md) · [All operations](https://skmtc.net/spreadconnect/apis/spreadconnect-fulfillment-service-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spreadconnect/spreadconnect-fulfillment-service-rest-api/revisions/c5159bc39a84/schema)
