# Query tracking status by tracking no

Retrieves the shipment’s tracking status, event history, estimated delivery date, and associated origin/destination location details as reported by the carrier.

Endpoint: GET /api/shipment/tracking_by_tracking_no
Version: v2
Security: BearerAuth

## Query parameters:

  - `tracking_no` (string, required)
    The carrier-specific tracking number that can be used to track the Shipment. A value will only be returned if the Rate is for a trackable Shipment and if the Transactions has been processed successfully.
    Example: "9234690381085700XXXXX"

  - `carrier_code` (string, required)
    Enum: "USPS", "UPS", "AMAZON_SHIPPING"

## Response 200 fields (application/json):

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

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

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

  - `data.status` (string)
    Current shipment status. Possible values include:
  - created: The shipment label has been generated but not yet scanned by the carrier.  
    Indicates the shipping process has not started.
  
  - available_for_pickup: 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.
  
  - in_transit: 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.
  
  - out_for_delivery: 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.
  
  - delivered: The package has been successfully delivered and signed for by the recipient.  
    Indicates the shipping process is complete.
  
  - return_to_sender: The package is being returned to the sender due to failed delivery or other issues.  
    Indicates a reverse logistics process.
  
  - voided: The shipping label has been voided and the package will not be processed.  
    Indicates the shipment has been canceled or invalidated.
  
  - error: An error occurred during shipment handling.  
    Indicates carrier-side issues that may require manual intervention.
  
  - seized_by_law_enforcement: The package was seized by law enforcement authorities.  
    Indicates compliance or legal issues affecting the shipment.
  
  - unknown: 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.estimate_delivery_date` (string)
    Estimated delivery date and time for the shipment, returned in the recipient's local timezone (timezone offset not included).
    Example: "2025-08-26 22:37:27"

  - `data.original_tracking_location` (object)
    Location information reported by the carrier. Fields such as city, state, zipcode, and country may be returned depending on carrier data availability.

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

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

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

  - `data.original_tracking_location.country` (string)

  - `data.destination_tracking_location` (object)
    Location information reported by the carrier. Fields such as city, state, zipcode, and country may be returned depending on carrier data availability.

  - `data.first_scan_date` (string)
    Timestamp of the first carrier scan for the shipment. Represents when the package was initially processed or received by the carrier. Returned in the event’s local time.
    Example: "2025-11-14T14:07:33Z"

  - `data.first_scan_description` (string)
    Description of the first carrier scan event. Indicates the initial status or processing message recorded when the shipment was first scanned.
    Example: "Package is in transit to a UPS facility"

  - `data.first_scan_location` (object)
    Location information reported by the carrier. Fields such as city, state, zipcode, and country may be returned depending on carrier data availability.

  - `data.scanned_time` (string)
    Timestamp indicating when the shipment entered its current status.  
This value represents the carrier-recorded scan time of the most recent status update (for example, when the status changed to in_transit).  
The timestamp is returned in the local time of the event’s location (timezone offset not included).
    Example: "2025-11-14T14:07:33Z"

  - `data.location` (object)
    Location information reported by the carrier. Fields such as city, state, zipcode, and country may be returned depending on carrier data availability.

  - `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)
    Timestamps are shown in the local time of the event’s location (timezone offset not included).
    Example: "2025-09-15 09:22:36"