1. Global Express Tracking Data API
Trackingeyes-API
🇺🇸 English
  • 🇨🇳 中文
  • 🇺🇸 English
  • First Call
  • Authentication
    • Request Signature Generation Example
    • Get Signature Token
      POST
  • Basic Information
    • Get Supported Port Codes
      GET
    • Get Supported Carrier Codes
      GET
    • Get Supported Airline Codes
      GET
  • Ocean Data API
    • Ocean Data
      • Ocean Data Support List
      • Ocean Data Status Code
      • Ocean Tracking
        • Batch Shipment Subscription API
        • Shipment Details Push API
        • Shipment On-demand Update API
        • Shipment Details Download API
        • Shipment Exception Alert Push API
      • On-demand Request
        • Batch On-demand Request API
        • On-demand Request Push API
    • China Terminal Data
      • China Terminal Data Support List
      • China Terminal Data Subscription API
      • China Terminal Data Details Push API
      • China Terminal Data Details Download API
    • Container Visual Tracking
      • Iframe Embedding Documentation
      • Container Visual Tracking API
    • China Vessel Call Plan
      • China Vessel Call Plan Data Support List
      • China Vessel Call Plan Query API
  • Air Data API
    • Air Tracking
      • Air Data Support List
      • Air Data Status Code
      • Batch Shipment Subscription API
      • Shipment Details Push API
      • Batch Shipment Details Download API
  • Multimodal Transport API
    • Multimodal Transport API Guide
    • Logistics Order Upload API
      POST
    • Segment Shipment Subscription API
      POST
    • Segment Shipment Ownership Update API
      POST
    • Manual Shipment Status Upload API
      POST
    • Logistics Order Event Push API
      POST
    • Logistics Order Tracking Download API
      GET
    • Multimodal Transport Exception Alert Push API
      POST
  • Al Vessel Prediction API
    • AI Iframe Embedding Documentation
    • Single Vessel Query API
      GET
    • Current Status API
      GET
    • Port Call Prediction API
      GET
    • Vessel Track API
      GET
    • Global Port Congestion Query API
      GET
  • Schedule API
    • Port to Port Schedule
      • Carrier Support List
      • Origin Port Support List
      • Iframe Embedding Documentation
      • Port to Port Schedule Query API
      • Port to Port Schedule Paged Push API
    • Vessel Schedule
      • Carrier Support List
      • Vessel Schedule Query API
      • Vessel Schedule Push API
  • Overseas Data API
    • Global Terminal Data
      • Global Terminal Data Support List
      • Global Terminal Data Subscription API
      • Global Terminal Data Push API
      • Global Terminal Data Download API
    • US Customs Clearance Data
      • US Customs Clearance Data Carrier List
      • US Customs Clearance Data Support List
      • US Customs Clearance Data Subscription API
      • US Customs Clearance Data Push API
      • US Customs Clearance Data Query API
      • US Customs Clearance On-demand Update API
      • In Bond Query API
  • Global Express Tracking Data API
    • Global Express Tracking Data Sluggroup List
    • Global Express Data Subscription API
      POST
    • Global Express Data Push API
      POST
    • Global Express Data Download API
      GET
  • China Inland Data API
    • China Equipment Interchange Receipt
      • EIR Query API
    • Qingdao Depot Data
      • Qingdao Depot Data Support List
      • Qingdao Depot Data Push API
      • Qingdao Depot Data Subscription API
      • Qingdao Depot Data Download API
    • China Container Truck GPS
      • China Container Truck Positioning API
      • China Container Truck Trajectory API
      • China Container Truck Route Planning API
  • China Customs Data API
    • Customs Declaration Data
      • Customs Declaration Data Subscription API
      • Customs Declaration Data Push API
      • Customs Declaration Data Download API
    • Manifest Data
      • Manifest Data Subscription API
      • Manifest Data Push API
      • Manifest Data Download API
  1. Global Express Tracking Data API

Global Express Data Push API

POST
https://api.trackingeyes.com/push/15-express/tracking
1.
Please provide the API address of your company that receives the pushed data. Thank you!
2.
All time fields are strings in the format "yyyy-MM-dd HH:mm:ss"; if a time has no value, it is an empty string "".

Request

Body Params application/json

Example
[
    {
        "id": "1927637327448223700",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "status": "S",
        "errorDes": "",
        "trackNo": "1ZRX56750452242446",
        "slug": "ups",
        "slugGroup": "",
        "language": "en",
        "transitDays": "1",
        "isActive": "Y",
        "orgCountryCd": "CHN",
        "orgState": "",
        "orgCity": "SUZHOU",
        "orgPostCd": "215021",
        "org": "SUZHOU, 215021, CN, China",
        "dstCountryCd": "GBR",
        "dstState": "",
        "dstCity": "PETERSFIELD",
        "dstPostCd": "GU32 3QG",
        "dst": "PETERSFIELD, GU32 3QG, GB, United Kingdom",
        "etd": "2025-05-30 23:59:00",
        "atd": "",
        "atp": "2025-05-28 12:28:32",
        "etdPromised": "",
        "etdByAs": "",
        "pieces": "",
        "weight": "6.4 kg",
        "shipmentType": "UPS Worldwide Express Saver",
        "signedBy": "",
        "tag": "InTransit",
        "subTag": "InTransit_007",
        "subTagMsg": "Departure Scan",
        "trackCount": "8",
        "dtpSupport": "Y",
        "delType": "",
        "pickupStation": "",
        "pickupNote": "",
        "courierUrl": "https://www.ups.com/track?loc=en_gb&requester=QUIC&tracknum=1ZRX56750452242446/trackdetails",
        "courierModifyUrl": "https://www.ups.com/track?loc=en_gb&requester=QUIC&tracknum=1ZRX56750452242446/trackdetails",
        "onTimeStatus": "trending-on-time",
        "onTimeDif": "0",
        "nextSlug": "",
        "nextTrackNo": "",
        "endStatus": "",
        "endId": "0",
        "trackStatus": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2025-05-28 16:05:27",
        "firstUpdateTime": "2025-05-28 18:35:05",
        "dataUpdateTime": "2025-05-29 12:35:16",
        "checkPoints": [
            {
                "sno": 1,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "",
                "postCd": "",
                "station": "CN, China",
                "checkPointTime": "2025-05-28 12:02:05",
                "tag": "InfoReceived",
                "subTag": "InfoReceived_001",
                "subTagMsg": "Info Received",
                "rawTag": "MP",
                "messageCn": "",
                "messageEn": "Shipper created a label, UPS has not received the package yet."
            },
            {
                "sno": 2,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Suzhou",
                "postCd": "",
                "station": "Suzhou, CN, China",
                "checkPointTime": "2025-05-28 12:28:32",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "OR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 3,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Suzhou",
                "postCd": "",
                "station": "Suzhou, CN, China",
                "checkPointTime": "2025-05-28 15:30:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 4,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-28 16:30:00",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "AR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 5,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 01:26:43",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "EP",
                "messageCn": "",
                "messageEn": "Export Scan"
            },
            {
                "sno": 6,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 06:03:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 7,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 06:17:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 8,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "KOR",
                "state": "",
                "city": "Incheon",
                "postCd": "",
                "station": "Incheon, KR, Korea, Republic Of",
                "checkPointTime": "2025-05-29 08:55:00",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "AR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 9,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "KOR",
                "state": "",
                "city": "Incheon",
                "postCd": "",
                "station": "Incheon, KR, Korea, Republic Of",
                "checkPointTime": "2025-05-29 11:20:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            }
        ]
    }
]

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.trackingeyes.com/push/15-express/tracking' \
--header 'Content-Type: application/json' \
--data '[
    {
        "id": "1927637327448223700",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "status": "S",
        "errorDes": "",
        "trackNo": "1ZRX56750452242446",
        "slug": "ups",
        "slugGroup": "",
        "language": "en",
        "transitDays": "1",
        "isActive": "Y",
        "orgCountryCd": "CHN",
        "orgState": "",
        "orgCity": "SUZHOU",
        "orgPostCd": "215021",
        "org": "SUZHOU, 215021, CN, China",
        "dstCountryCd": "GBR",
        "dstState": "",
        "dstCity": "PETERSFIELD",
        "dstPostCd": "GU32 3QG",
        "dst": "PETERSFIELD, GU32 3QG, GB, United Kingdom",
        "etd": "2025-05-30 23:59:00",
        "atd": "",
        "atp": "2025-05-28 12:28:32",
        "etdPromised": "",
        "etdByAs": "",
        "pieces": "",
        "weight": "6.4 kg",
        "shipmentType": "UPS Worldwide Express Saver",
        "signedBy": "",
        "tag": "InTransit",
        "subTag": "InTransit_007",
        "subTagMsg": "Departure Scan",
        "trackCount": "8",
        "dtpSupport": "Y",
        "delType": "",
        "pickupStation": "",
        "pickupNote": "",
        "courierUrl": "https://www.ups.com/track?loc=en_gb&requester=QUIC&tracknum=1ZRX56750452242446/trackdetails",
        "courierModifyUrl": "https://www.ups.com/track?loc=en_gb&requester=QUIC&tracknum=1ZRX56750452242446/trackdetails",
        "onTimeStatus": "trending-on-time",
        "onTimeDif": "0",
        "nextSlug": "",
        "nextTrackNo": "",
        "endStatus": "",
        "endId": "0",
        "trackStatus": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2025-05-28 16:05:27",
        "firstUpdateTime": "2025-05-28 18:35:05",
        "dataUpdateTime": "2025-05-29 12:35:16",
        "checkPoints": [
            {
                "sno": 1,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "",
                "postCd": "",
                "station": "CN, China",
                "checkPointTime": "2025-05-28 12:02:05",
                "tag": "InfoReceived",
                "subTag": "InfoReceived_001",
                "subTagMsg": "Info Received",
                "rawTag": "MP",
                "messageCn": "",
                "messageEn": "Shipper created a label, UPS has not received the package yet."
            },
            {
                "sno": 2,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Suzhou",
                "postCd": "",
                "station": "Suzhou, CN, China",
                "checkPointTime": "2025-05-28 12:28:32",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "OR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 3,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Suzhou",
                "postCd": "",
                "station": "Suzhou, CN, China",
                "checkPointTime": "2025-05-28 15:30:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 4,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-28 16:30:00",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "AR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 5,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 01:26:43",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "EP",
                "messageCn": "",
                "messageEn": "Export Scan"
            },
            {
                "sno": 6,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 06:03:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 7,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 06:17:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 8,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "KOR",
                "state": "",
                "city": "Incheon",
                "postCd": "",
                "station": "Incheon, KR, Korea, Republic Of",
                "checkPointTime": "2025-05-29 08:55:00",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "AR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 9,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "KOR",
                "state": "",
                "city": "Incheon",
                "postCd": "",
                "station": "Incheon, KR, Korea, Republic Of",
                "checkPointTime": "2025-05-29 11:20:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            }
        ]
    }
]'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": 200,
    "type": "S",
    "message": null,
    "time": "2023-12-13 01:20:38"
}
Modified at 2026-10-18 10:01:10
Previous
Global Express Data Subscription API
Next
Global Express Data Download API
Built with