# Query Shipment Tracking Status by 


Indicates the current location or state of a package within the supply chain (e.g., in_transit, out for delivery). 
Use the tracking status object to monitor shipment progress. 
In test mode, this API will return fixed mock data to facilitate testing and integration validation.


Endpoint: GET /api/shipment/tracking_by_platform_uk_id
Version: v1.0.5
Security: BearerAuth

## Query parameters:

  - `platform_uk_id` (string, required)
    A unique identifier provided by the calling party (e.g., the caller’s order number). Each  must correspond to exactly one shipment and cannot be reused across multiple shipments.
    Example: "platformUkId175377917713"

## Response 200 fields (*/*):

  - `code` (string, required)
    API response code; "ok" indicates success.
    Example: "ok"

  - `msg` (string, required)
    Human-readable response message.
    Example: "ok"

  - `data` (object, required)
    This is the latest tracking record.

  - `data.scanned_time` (string)
    The UTC timestamp when the package was scanned, in ISO 8601 format.
    Example: "2025-08-26T22:37:27Z"

  - `data.status` (string)
    Current shipment status. Possible values include:
  - : The shipment label has been generated but not yet scanned by the carrier.  
    Indicates the shipping process has not started.
  
  - : The package has arrived at a designated location and is waiting for the recipient to collect it.  
    Indicates customer action is required to retrieve the shipment.
  
  - : The package is in transit, moving through different facilities or checkpoints.  
    Indicates the shipment is on its way but has not yet reached the destination.
  
  - : The package has been handed over to the courier and is on its final delivery route.  
    Indicates the shipment is in the last-mile delivery stage.
  
  - : The package has been successfully delivered and signed for by the recipient.  
    Indicates the shipping process is complete.
  
  - : The package is being returned to the sender due to failed delivery or other issues.  
    Indicates a reverse logistics process.
  
  - : The shipping label has been voided and the package will not be processed.  
    Indicates the shipment has been canceled or invalidated.
  
  - : An error occurred during shipment handling.  
    Indicates carrier-side issues that may require manual intervention.
  
  - : The package was seized by law enforcement authorities.  
    Indicates compliance or legal issues affecting the shipment.
  
  - : The shipment status is unknown or no valid update is available from the carrier.  
    Indicates no current tracking information.
    Enum: "created", "available_for_pickup", "in_transit", "out_for_delivery", "delivered", "return_to_sender", "voided", "error", "seized_by_law_enforcement", "unknown"

  - `data.message` (string)
    Human-readable description of the status.
    Example: "USPS in possession of item"

  - `data.location` (object)
    Event location (if available).

  - `data.location.city` (string)
    Example: "BROOKLYN"

  - `data.location.state` (string)
    Example: "NY"

  - `data.location.zipcode` (string)
    Example: 91777

  - `data.tracking_events` (array)

  - `data.tracking_events.status` (string)
    Example: "in_transit"

  - `data.tracking_events.message` (string)
    Human-readable description.
    Example: "Arrived at USPS Facility"

  - `data.tracking_events.event_time` (string)
    ISO 8601 timestamp, e.g. "2025-09-15T09:22:36Z".
    Example: "2025-09-15T09:22:36Z"