---
title: "Tracking endpoint to retrieve tracking info about shipments using shipiumTrackingId"
method: GET
path: "/api/v1/tracking/{shipiumTrackingId}"
tags: ["track"]
---

# Tracking endpoint to retrieve tracking info about shipments using shipiumTrackingId

`GET /api/v1/tracking/{shipiumTrackingId}`

## Path parameters

- `shipiumTrackingId` string, required

## Query parameters

- `excludeEvents` boolean

## Response `200`

Result

- TrackingDto
  - `shipiumTrackingId` string
  - `shipiumShipmentId` string
  - `partnerShipmentId` string
  - `shipiumTenantId` string
  - `partnerTenantId` string
  - `carrierId` string
  - `carrierTrackingId` string
  - `carrierServiceMethodId` string
  - `shipmentStatus` 'Registered' | 'Label Printed' | 'In Transit' | 'Out For Delivery' | 'Delivered' | 'Exception' | 'Return to Sender: In Transit' | 'Return to Sender: Out For Delivery' | 'Return to Sender: Delivered' | 'Return to Sender: Exception'
  - `shippedDateTime` string, date-time
  - `deliveredAtDateTime` string, date-time
  - `carrierEstimatedDeliveryDate` string, date-time
  - `originalCarrierEstimatedDeliveryDate` string, date-time
  - `partnerReferenceId` string
  - `partnerReferenceId2` string
  - `carrierTrackingLink` string
  - `trackingEvents` TrackingEventDto[]
    - `carrierDescription` string
    - `shipmentStatus` 'Registered' | 'Label Printed' | 'In Transit' | 'Out For Delivery' | 'Delivered' | 'Exception' | 'Return to Sender: In Transit' | 'Return to Sender: Out For Delivery' | 'Return to Sender: Delivered' | 'Return to Sender: Exception'
    - `eventDate` string, date-time
    - `postalCode` string
    - `country` string
    - `city` string
    - `region` string

## Other responses

- `400` — Invalid inputs were provided.
- `401` — Not authorized via OAuth
- `403` — Not authenticated via OAuth
- `404` — Tracking was not found

---

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