---
title: "Retrieve shipments."
method: GET
path: "/v1/shipments"
tags: ["Shipments V1"]
---

# Retrieve shipments.

`GET /v1/shipments`

This endpoint can be used to retrieve the shipments for a given authorized partner.

## Query parameters

- `datefrom` string, YYYY-MM-DD['T'HH:mm:ss.SSSXXX], required
- `limit` integer
- `next` string

## Response `200`

OK

- ShipmentListShipmentsV1
  - `links` LinkShipmentsV1[] — Contains one single link, which can be used as pointer for Cursor-based pagination.
    - `href` string — The url of the link
    - `rel` string — The relation type of the link. See also https://www.iana.org/assignments/link-relations/link-relations.xhtml. The relation type 'next' is used for paging. The relation type 'self' refers to the url of the ressource
  - `resources` ShipmentWithMinimumDetailsShipmentsV1[]
    - `creationDate` string
    - `shipmentId` string — Internal shipment identifier assigned by OTTO Market.
    - `trackingKey` TrackingKeyShipmentsV1
      - `carrier` 'DHL' | 'DHL_EXPRESS' | 'DPD' | 'GLS' | 'HERMES' | 'UPS' | 'ABIKS' | 'AJ' | 'AJE' | 'BTW' | 'BURSPED' | 'CARGOLINE' | 'CARGOBOARD' | 'CTL' | 'DACHSER' | 'DB_SCHENKER' | 'DHL_FREIGHT' | 'DHL_HOME_DELIVERY' | 'DSV' | 'ECE' | 'EMONS' | 'EPH_DIREKT' | 'FEDEX' | 'FROEDE' | 'GEIS' | 'GEL' | 'GRASSL' | 'GUETTLER' | 'HASENAUER' | 'HEPPNER' | 'HELLMANN' | 'HES' | 'HEUEL' | 'IDS' | 'ISG' | 'KIESSLING' | 'KOCH' | 'KUEHNE_NAGEL' | 'LOGWIN' | 'MEYER_JUMBO' | 'MIRJAN' | 'ORCARGO' | 'PALLETWAYS' | 'PEISKER' | 'RABEN_LOGISTIK' | 'REIMER' | 'REITHMEIER' | 'RHENUS' | 'RIECK' | 'SCHMIDT_GEVELSBERG' | 'SCHOCKEMOEHLE' | 'SIEVERS' | 'SIMPLE_LOGISTIK' | 'SPEEDTRANS' | 'SPT' | 'VERHOEK' | 'WEISS' | 'ZUFALL' | 'OTHER_FORWARDER', required — The carrier of the shipment.
      - `trackingNumber` string, required — The tracking number assigned by the carrier. <br> Required for parcel deliveries. <br> Optional for forwarder deliveries.
    - `states` ShipmentStateShipmentsV1[] — The history of tracking states of the shipment
      - `state` 'SENT' | 'ON_THE_WAY' | 'DELIVERED' | 'DELIVERED_FOR_PICKUP' | 'DELIVERY_ATTEMPT_FAILED' | 'ISSUE_OCCURRED', required — The tracking state of the shipment.
      - `occurredOn` string, required

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/otto/apis/otto-market-api.md) · [All operations](https://skmtc.dev/otto/apis/otto-market-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/otto/otto-market-api/revisions/b1bc133112bd/schema)