---
title: "Retrieve shipment by carrier and tracking number."
method: GET
path: "/v1/shipments/carriers/{carrier}/trackingnumbers/{trackingNumber}"
tags: ["Shipments V1"]
---

# Retrieve shipment by carrier and tracking number.

`GET /v1/shipments/carriers/{carrier}/trackingnumbers/{trackingNumber}`

## Request

- Base URL: `https://api.otto.market`
- URL: `https://api.otto.market/v1/shipments/carriers/{carrier}/trackingnumbers/{trackingNumber}`
- Auth: HTTP bearer

This endpoint can be used to retrieve a shipment by carrier and tracking number.

## Path parameters

- `carrier` 'DHL' | 'DHL_EXPRESS' | 'DPD' | 'GLS' | 'HERMES' | 'UPS' | 'ABIKS' | 'AJ' | 'AJE' | 'BTW' | 'BURSPED' | 'CARGOLINE' | 'CARGOBOARD' | 'CTL' | 'DACHSER' | 'DB_SCHENKER' | 'DHL_FREIGHT' | 'DHL_HOME_DELIVERY' | 'DHL_2_MANN_HANDLING' | 'DSV' | 'ECE' | 'EMONS' | 'EPH_DIREKT' | 'FEDEX' | 'FROEDE' | 'GEIS' | 'GEL' | 'GRASSL' | 'GUETTLER' | 'HASENAUER' | 'HEPPNER' | 'HELLMANN' | 'HES' | 'HEUEL' | 'IDS' | 'ISG' | 'KIESSLING' | 'KOCH' | 'KUEHNE_NAGEL' | 'LOGWIN' | 'LOOWAY' | '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
- `trackingNumber` string, required

## Response `200`

OK

- ShipmentShipmentsV1: A shipment with full details.
  - `shipmentId` string: Internal shipment identifier assigned by OTTO Market.
  - `creationDate` string
  - `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' | 'DHL_2_MANN_HANDLING' | 'DSV' | 'ECE' | 'EMONS' | 'EPH_DIREKT' | 'FEDEX' | 'FROEDE' | 'GEIS' | 'GEL' | 'GRASSL' | 'GUETTLER' | 'HASENAUER' | 'HEPPNER' | 'HELLMANN' | 'HES' | 'HEUEL' | 'IDS' | 'ISG' | 'KIESSLING' | 'KOCH' | 'KUEHNE_NAGEL' | 'LOGWIN' | 'LOOKWAY' | '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.
  - `shipDate` string
  - `shipFromAddress` AddressShipmentsV1: The warehouse or location from which the shipment will be picked up for final delivery.
    - `city` string, required: The city from where the shipment is sent.
    - `countryCode` string, required: The country code according to [iso-3166-1-alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) from where the shipment is sent.
    - `zipCode` string, required: The zip code from where the shipment is sent.
  - `positionItems` PositionItemShipmentsV1[]: The position items included in the shipment.
    - `positionItemId` string, uuid, required: The ID of a position item of the sales order from the OTTO Market, as defined in the Order API.
    - `salesOrderId` string, uuid, required: The ID of the sales order from the OTTO Market, as defined in the Order API.
    - `returnTrackingKey` ReturnTrackingKeyShipmentsV1, required: The return tracking key for the return process. <br> **Required for parcel deliveries.** <br> **Optional for forwarder deliveries.** <br> Each position item can have its own return tracking key.
      - `carrier` 'DHL' | 'GLS' | 'HERMES', required: The carrier for the return process, which can differ from the carrier used to deliver the shipment to the customer. Please be aware that this carrier can not differ from the chosen carrier in the OPC portal.
      - `trackingNumber` string, required: The tracking number (or return tracking number) assigned by the carrier.
    - `returnAddressCarrierId` string, uuid: Unique identifier for the return address and the return carrier combination. A returnAddressCarrierId is required when a partner has multiple return addresses/carriers. This identifier can be obtained through the ReturnsWarehouse API or in the Partner-Portal. Note that all position items within the same shipment must have the same returnAddressCarrierId.
  - `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
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-02** `29ca75cdb016`: 1 warning, 1 info
  - added the new `LOOKWAY` enum value to the `trackingKey/carrier` response property for the response status `200`
  - added the new enum value `LOOWAY` to the `path` request parameter `carrier`
- **2026-09-10** `3d020f15ab4d`: 1 warning, 1 info
  - added the new `DHL_2_MANN_HANDLING` enum value to the `trackingKey/carrier` response property for the response status `200`
  - added the new enum value `DHL_2_MANN_HANDLING` to the `path` request parameter `carrier`
- **2026-09-01** `b1bc133112bd`: 25 warning, 24 info
  - added the new `ABIKS` enum value to the `trackingKey/carrier` response property for the response status `200`
  - added the new `AJ` enum value to the `trackingKey/carrier` response property for the response status `200`
  - added the new `AJE` enum value to the `trackingKey/carrier` response property for the response status `200`
  - added the new `CARGOBOARD` enum value to the `trackingKey/carrier` response property for the response status `200`
  - …45 more

[Operation history](https://skmtc.dev/otto/apis/otto-market-api/changes/v1/shipments/carriers/:carrier/trackingnumbers/:trackingNumber/get.md)

---

[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.dev/otto/apis/otto-market-api/revisions/cc8a74b62e87?raw)