---
title: "Get a shipment status"
method: POST
path: "/shipment/get/"
tags: ["Shipments"]
---

# Get a shipment status

`POST /shipment/get/`

Retrieve the current tracking status and event history of a shipment.

## Request body

- GetShipmentRequest
  - `tracking_number` string, required — Tracking number for the package.
  - `tracking_provider` string — Unique code of the tracking provider for that tracking.

## Response `200`

Shipment tracking data, or an error object when the tracking does not exist.

- ShipmentStatusResponse
  - `status` string — success or error.
  - `data` ShipmentData
    - `order_id` string
    - `tracking_number` string
    - `tracking_provider` string
    - `tracking_event_status` string — Current tracking status (e.g. pre_transit, in_transit, delivered).
    - `tracking_est_delivery_date` string, nullable
    - `origin_country` string, nullable
    - `destination_country` string, nullable
    - `delivery_number` string, nullable
    - `delivery_provider` string, nullable
    - `shipping_service` string, nullable
    - `last_event_time` string, nullable
    - `events` TrackingEvent[]
      - `object` string — Object type, e.g. TrackingDetail.
      - `message` string
      - `description` string
      - `status` string
      - `status_detail` string
      - `datetime` string
      - `source` string
      - `tracking_location` TrackingLocation
        - `object` string — Object type, e.g. TrackingLocation.
        - `city` string
        - `state` string
        - `country` string
        - `zip` string
    - `destination_events` TrackingEvent[], nullable
      - `object` string — Object type, e.g. TrackingDetail.
      - `message` string
      - `description` string
      - `status` string
      - `status_detail` string
      - `datetime` string
      - `source` string
      - `tracking_location` TrackingLocation
        - `object` string — Object type, e.g. TrackingLocation.
        - `city` string
        - `state` string
        - `country` string
        - `zip` string
  - `message` string — Response message (present on error, e.g. "tracking information is not exist").

## Other responses

- `400` — The requested parameter is missing (e.g. order id, tracking number, or shipping provider not found).
- `401` — Unauthorized API access. Causes include `ssl_error` (store URL is not HTTPS) or `unauthorized` (invalid API key or the store does not exist).
- `404` — The API route does not exist. Check the URL and try again.
- `500` — The server encountered an unexpected condition that prevented it from fulfilling the request.

---

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