Skip to content
/Tracking

Query tracking status by tracking no (with UTC offset)

Request

Retrieves the current shipment tracking event, first scan tracking event, and the complete tracking event history as reported by the carrier.

This endpoint returns all tracking event timestamps in ISO 8601 format with the UTC offset included, allowing clients to accurately interpret local event times across different time zones.

Security
BearerAuth
Query
tracking_nostringrequired

tracking number

Example:tracking_no=940013620842281000000
carrier_codestringrequired

carrier code

Example:carrier_code=USPS
GET
/api/shipment/direct/tracking_by_tracking_no
curl -i -X GET \
  'https://x-api.shipsaving.com/api/shipment/direct/tracking_by_tracking_no?tracking_no=940013620842281000000&carrier_code=USPS' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
codestring

API response code; "ok" indicates success.

Example:"ok"
msgstring

Human-readable response message.

Example:"ok"
dataobject(TrackingDataWUtcOffset)

This is the latest tracking record.

Response
{
  "code": "ok",
  "msg": "ok",
  "data": {
    "status": "in_transit",
    "message": "USPS in possession of item",
    "status_summary": "Your item has been delivered and is available at xxx at 9:00 am on xxx in xxxx, xx 20000.",
    "recipient_name": "Alice",
    "scanned_time": "2025-12-16T10:48:28-05:00",
    "location": { … },
    "return_to_sender": true,
    "first_scan_date": "2025-11-14T14:07:33-05:00",
    "first_scan_description": "Package is in transit to a UPS facility",
    "first_scan_location": { … },
    "tracking_events": [ … ]
  }
}