---
title: "Returns a list of shipments shipped"
method: GET
path: "/orders/shipments/shipped"
tags: ["orders"]
---

# Returns a list of shipments shipped

`GET /orders/shipments/shipped`

## Request

- Base URL: `https://api.brandlovers.com/marketplace/v1`
- URL: `https://api.brandlovers.com/marketplace/v1/orders/shipments/shipped`
- Auth: none declared. Required headers: `authorization`

Returns a list of shipments shipped. By Default returns items ordered by dateCreated folowed by last update

## Query parameters

- `status` 'NEW' | 'APPROVED' | 'DECLINED' | 'PENDING'
- `offset` integer
- `limit` integer

## Headers

- `authorization` string, required

## Response `200`

Success!

- GetOrdersShipments
  - `shipments` OrderShippmentStatus[]: Order Shippment Status
    - `shipmentId` string: Shippment unique Id
    - `trackingUrl` string: Courier tracking URL
    - `items` OrderItemReference[]
      - `skuSellerId` string, required: Unique Product Id (SKU) in the seller system. This is the key that defines witch product will be updated
      - `quantity` integer, required: Quantity of items
    - `status` string: Shipment status
    - `errors` Error[]
      - `type` string, required: Error type
      - `message` string, required: Friendly message describing the error
      - `skuSellerId` string: When applicabe will include `skuSellerId` related to this error
  - `metadata` Metadata[]: Response payload
    - `key` string, required: JSON attribute key
    - `value` string, required: JSON object value

## Other responses

- `400`: Bad request.
- `401`: Access denied. You're not authenticated or token expired. Check your request header the `authorization` field is required.
- `403`: Server refused to process your request. Please check the API SLA and reduce number of requests per second.

## Changes

- **2016-06-13** (v1) `b73fe7ca6d89`: 2 info
  - api operation id `getOrdersshipmentsent` removed and replaced with ``
  - removed the non-success response with the status `404`
- **2016-06-13** (v1) `a5b49b54d026`: 2 info
  - api operation id `getOrdersshipmentsent` was added
  - added the non-success response with the status `404`

[Operation history](https://skmtc.dev/brandlovers/apis/brandlovers-marketplace-api-v1/changes/orders/shipments/shipped/get.md)

---

[API](https://skmtc.dev/brandlovers/apis/brandlovers-marketplace-api-v1.md) - [All operations](https://skmtc.dev/brandlovers/apis/brandlovers-marketplace-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/brandlovers/apis/brandlovers-marketplace-api-v1/revisions/cb3af6151ae4?raw)
