Get Logistics Tracking

GET

/logistics/202604/orders/{order_id}/tracking

Use this API to retrieve detailed logistics tracking information for an order. This API currently supports only cross-border trade (CBT) orders. Compared with Get Tracking, this API groups information by parcel and can include each parcel’s carrier, latest tracking number, and tracking-event history.

For the mapping between action_code and action_code_name, see https://partner.tiktokshop.com/docv2/page/37tihrdq.

Authorizations

• accessToken

Parameters

Path Parameters

order_id

required

string

TikTok Shop order ID.

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

order_id

TikTok Shop order ID.

string

logistics_details

A list of parcels in the order. Each item describes one parcel and can include its carrier, latest tracking number, and tracking-event history.

Array<object>

object

newest_tracking_no

The latest logistics tracking number for this parcel.

string

carrier_name

The carrier name.

string

track_list

A list of logistics tracking events for this parcel.

Array<object>

object

description

Description of this tracking event.

string

tracking_no

The logistics tracking number associated with this tracking event.

string

update_time_millis

Unix timestamp in milliseconds (GMT/UTC+00:00) when this tracking event was updated.

integer format: int64

action_code

Action code of this tracking event. It is an enumerated status value; the full enumeration list is maintained by the business side. Refer: action_code/action_code_name mapping details https://partner.tiktokshop.com/docv2/page/37tihrdq

integer format: int64

action_code_name

Machine-readable status name corresponding to action_code. For action code and name mapping details, see https://partner.tiktokshop.com/docv2/page/37tihrdq.

string

Example

{
  "code": 0,
  "data": {
    "order_id": "577071607420326620",
    "logistics_details": [
      {
        "newest_tracking_no": "861651122474",
        "carrier_name": "J&T Express",
        "track_list": [
          {
            "description": "Package has been delivered!\\n",
            "tracking_no": "861651122474",
            "update_time_millis": 1694686949000,
            "action_code": 50101,
            "action_code_name": "signed_personally"
          }
        ]
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}