API Documentation

📘 中文版

POST tracking - Get Tracking

URL: /api/order/tracking　·　Description: Get the logistics tracking of an order.

Parameters

Parameter	Required	Type	Description
order_id	Yes	int	Order ID (only the current vendor's own orders can be operated)

Request Example

POST /api/order/tracking
Header: vendor-token: xxxxx
Content-Type: application/json
{
    "order_id": 1024
}

Response Example (data is the channel's unified structure)

{
    "success": true,
    "message": "Tracking retrieved successfully!",
    "code": 200,
    "data": {
        "trackingNumber": "9212345678901234567890",   // Tracking number
        "status": "delivered",                 // Tracking status
        "statusCategory": "delivered",           // Status category
        "serviceTypeCode": "144",               // STC code
        "originCity": "LOS ANGELES",
        "originState": "CA",
        "originZIP": "90001",
        "destinationCity": "NEW YORK",
        "destinationState": "NY",
        "destinationZIP": "10001",
        "trackingEvents": [{
            "eventType": "Delivered, Left with Individual",
            "eventTimestamp": "2026-10-01T11:04:19",
            "eventCountry": "US",
            "eventCity": "DES PLAINES",
            "eventState": "IL",
            "eventZIP": "60016",
            "location": "DES PLAINES,IL,60016",
            "timeZone": "GMT-05:00",
            "eventCode": "01",
            "GMTTimestamp": "2026-10-01T16:04:19Z"
        }]
    }
}

data Field Reference

data field	Type	Description
trackingNumber	string	Tracking number
status / statusCategory	string	Tracking status / channel status category (e.g. delivered)
serviceTypeCode	string	STC code
origin* / destination*	string	Origin / destination city, state code, ZIP
trackingEvents	array	List of tracking events; each item has eventType / eventTimestamp / eventCountry / eventCity / eventState / eventZIP / location / timeZone / eventCode / GMTTimestamp