1. On-demand Request
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
          POST
        • On-demand Request Push API
          POST
    • 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
    • Current Status API
    • Port Call Prediction API
    • Vessel Track API
    • Global Port Congestion Query API
  • 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
    • Global Express Data Push API
    • Global Express Data Download API
  • 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. On-demand Request

On-demand Request Push API

POST
https://api.trackingeyes.com
1.
Please provide the API address of your company that receives the pushed data. Thank you!
2.
The push only returns the data obtained by the on-demand request API.

Request

Body Params application/json

Example
{
    "code": 200,
    "type": "S",
    "message": "",
    "data": [
        {
            "requestId": "2074030099108884480",
            "batchId": "0",
            "localKey": "",
            "blNo": "2328413440",
            "bkgNo": "2328413440",
            "ctnrNo": "",
            "carrierCd": "OOCL",
            "vesselName": "COSCO SHIPPING PEONY",
            "voyage": "038E",
            "plrCd": "THLCH",
            "plr": "Laem Chabang,Chon Buri,Thailand",
            "polCd": "THLCH",
            "pol": "Laem Chabang,Chon Buri,Thailand",
            "podCd": "USLGB",
            "pod": "Long Beach,Los Angeles,California,United States",
            "pldCd": "USCLE",
            "pld": "Cleveland,Cuyahoga,Ohio,United States",
            "cyOpenTime": "",
            "cyCutOffTime": "",
            "dlptTime": "2026-06-07 22:29:00",
            "etd": "2026-06-07 22:29:00",
            "eta": "2026-07-03 15:34:00",
            "ata": "2026-07-03 15:34:00",
            "etaPLD": "2026-07-06 08:00:00",
            "ataPLD": "",
            "dschTime": "2026-07-03 15:34:00",
            "pickupreference": "Norfolk Southern - Cleveland ",
            "railcode": "Norfolk Sout",
            "terminalPld": "Norfolk Southern - Cleveland ",
            "terminalDtp": "",
            "shipRolled": "",
            "ctnrInfos": [
                {
                    "ctnrNo": "CSNU6902722",
                    "sealNo": "",
                    "ctnrSize": "40",
                    "ctnrType": "HQ",
                    "pkgs": "",
                    "gwgt": "",
                    "vgm": "",
                    "currentStatusCd": "BDAR",
                    "currentStatus": "BOARD ARRIVE",
                    "currentStatusTime": "2026-07-03 15:34:00",
                    "currentPlaceCd": "USLGB",
                    "currentPlace": "LONG BEACH,LOS ANGELES,CALIFORNIA,UNITED STATES",
                    "chargeDatas": [
                        {
                            "chargeType": "PODDemurrage",
                            "lfd": "",
                            "freeDayDesc": "1 Working Days"
                        },
                        {
                            "chargeType": "PODDetention",
                            "lfd": "",
                            "freeDayDesc": "10 Working Days"
                        }
                    ],
                    "ctnrStatus": [
                        {
                            "statusCd": "STSP",
                            "statusDesc": "提空箱",
                            "statusDescEn": "Container Picked Up(Facility)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-05-28 16:35:00",
                            "place": "MPJ DISTRIBUTION CENTER CO.,LTD.,LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THCHB",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "GITM",
                            "statusDesc": "起运港进场",
                            "statusDescEn": "Container Received by Carrier(Origin)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-05-29 13:48:00",
                            "place": "HUTCHISON LAEMCHABANG TERMINAL LTD,LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THLCH",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "TRAR",
                            "statusDesc": "卡车抵达\t",
                            "statusDescEn": "Arrived(Port of Load)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-05-29 13:48:00",
                            "place": "LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THLCH",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "LOBD",
                            "statusDesc": "装船",
                            "statusDescEn": "Loaded(Port of Load)",
                            "vesselName": "COSCO SHIPPING PEONY",
                            "voyage": "038E",
                            "eventTime": "2026-06-07 05:05:00",
                            "place": "LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THLCH",
                            "transportMode": "VESSEL",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "DLPT",
                            "statusDesc": "离港",
                            "statusDescEn": "DEPARTURE FROM LOAD PORT",
                            "vesselName": "COSCO SHIPPING PEONY",
                            "voyage": "038E",
                            "eventTime": "2026-06-07 22:29:00",
                            "place": "LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THLCH",
                            "transportMode": "VESSEL",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "",
                            "statusDesc": "",
                            "statusDescEn": "Freight Charges Settled",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-01 17:47:00",
                            "place": "CLEVELAND,CUYAHOGA,OHIO,UNITED STATES",
                            "placeCd": "USCLE",
                            "transportMode": "",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "CGRL",
                            "statusDesc": "船东放货",
                            "statusDescEn": "Carrier Released",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-01 17:47:00",
                            "place": "CLEVELAND,CUYAHOGA,OHIO,UNITED STATES",
                            "placeCd": "USCLE",
                            "transportMode": "",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "",
                            "statusDesc": "",
                            "statusDescEn": "Customs Released(Port of Discharge)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-02 09:10:00",
                            "place": "LONG BEACH,LOS ANGELES,CALIFORNIA,UNITED STATES",
                            "placeCd": "USLGB",
                            "transportMode": "",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "DCRL",
                            "statusDesc": "目的港海关放行",
                            "statusDescEn": "Carrier and Customs Released",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-02 09:10:00",
                            "place": "LONG BEACH,LOS ANGELES,CALIFORNIA,UNITED STATES",
                            "placeCd": "USLGB",
                            "transportMode": "",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "BDAR",
                            "statusDesc": "抵达卸货港",
                            "statusDescEn": "BOARD ARRIVE",
                            "vesselName": "COSCO SHIPPING PEONY",
                            "voyage": "038E",
                            "eventTime": "2026-07-03 15:34:00",
                            "place": "LONG BEACH,LOS ANGELES,CALIFORNIA,UNITED STATES",
                            "placeCd": "USLGB",
                            "transportMode": "VESSEL",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "PDAR",
                            "statusDesc": "抵达目的地",
                            "statusDescEn": "PLACE OF DELIVERY ARRIVAL",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-06 08:00:00",
                            "place": "CLEVELAND,CUYAHOGA,OHIO,UNITED STATES",
                            "placeCd": "USCLE",
                            "transportMode": "",
                            "isEstimate": true,
                            "sourceCd": "1"
                        }
                    ]
                }
            ]
        }
    ]
}

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' \
--header 'Content-Type: application/json' \
--data '{
    "code": 200,
    "type": "S",
    "message": "",
    "data": [
        {
            "requestId": "2074030099108884480",
            "batchId": "0",
            "localKey": "",
            "blNo": "2328413440",
            "bkgNo": "2328413440",
            "ctnrNo": "",
            "carrierCd": "OOCL",
            "vesselName": "COSCO SHIPPING PEONY",
            "voyage": "038E",
            "plrCd": "THLCH",
            "plr": "Laem Chabang,Chon Buri,Thailand",
            "polCd": "THLCH",
            "pol": "Laem Chabang,Chon Buri,Thailand",
            "podCd": "USLGB",
            "pod": "Long Beach,Los Angeles,California,United States",
            "pldCd": "USCLE",
            "pld": "Cleveland,Cuyahoga,Ohio,United States",
            "cyOpenTime": "",
            "cyCutOffTime": "",
            "dlptTime": "2026-06-07 22:29:00",
            "etd": "2026-06-07 22:29:00",
            "eta": "2026-07-03 15:34:00",
            "ata": "2026-07-03 15:34:00",
            "etaPLD": "2026-07-06 08:00:00",
            "ataPLD": "",
            "dschTime": "2026-07-03 15:34:00",
            "pickupreference": "Norfolk Southern - Cleveland ",
            "railcode": "Norfolk Sout",
            "terminalPld": "Norfolk Southern - Cleveland ",
            "terminalDtp": "",
            "shipRolled": "",
            "ctnrInfos": [
                {
                    "ctnrNo": "CSNU6902722",
                    "sealNo": "",
                    "ctnrSize": "40",
                    "ctnrType": "HQ",
                    "pkgs": "",
                    "gwgt": "",
                    "vgm": "",
                    "currentStatusCd": "BDAR",
                    "currentStatus": "BOARD ARRIVE",
                    "currentStatusTime": "2026-07-03 15:34:00",
                    "currentPlaceCd": "USLGB",
                    "currentPlace": "LONG BEACH,LOS ANGELES,CALIFORNIA,UNITED STATES",
                    "chargeDatas": [
                        {
                            "chargeType": "PODDemurrage",
                            "lfd": "",
                            "freeDayDesc": "1 Working Days"
                        },
                        {
                            "chargeType": "PODDetention",
                            "lfd": "",
                            "freeDayDesc": "10 Working Days"
                        }
                    ],
                    "ctnrStatus": [
                        {
                            "statusCd": "STSP",
                            "statusDesc": "提空箱",
                            "statusDescEn": "Container Picked Up(Facility)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-05-28 16:35:00",
                            "place": "MPJ DISTRIBUTION CENTER CO.,LTD.,LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THCHB",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "GITM",
                            "statusDesc": "起运港进场",
                            "statusDescEn": "Container Received by Carrier(Origin)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-05-29 13:48:00",
                            "place": "HUTCHISON LAEMCHABANG TERMINAL LTD,LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THLCH",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "TRAR",
                            "statusDesc": "卡车抵达\t",
                            "statusDescEn": "Arrived(Port of Load)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-05-29 13:48:00",
                            "place": "LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THLCH",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "LOBD",
                            "statusDesc": "装船",
                            "statusDescEn": "Loaded(Port of Load)",
                            "vesselName": "COSCO SHIPPING PEONY",
                            "voyage": "038E",
                            "eventTime": "2026-06-07 05:05:00",
                            "place": "LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THLCH",
                            "transportMode": "VESSEL",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "DLPT",
                            "statusDesc": "离港",
                            "statusDescEn": "DEPARTURE FROM LOAD PORT",
                            "vesselName": "COSCO SHIPPING PEONY",
                            "voyage": "038E",
                            "eventTime": "2026-06-07 22:29:00",
                            "place": "LAEM CHABANG,CHON BURI,THAILAND",
                            "placeCd": "THLCH",
                            "transportMode": "VESSEL",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "",
                            "statusDesc": "",
                            "statusDescEn": "Freight Charges Settled",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-01 17:47:00",
                            "place": "CLEVELAND,CUYAHOGA,OHIO,UNITED STATES",
                            "placeCd": "USCLE",
                            "transportMode": "",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "CGRL",
                            "statusDesc": "船东放货",
                            "statusDescEn": "Carrier Released",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-01 17:47:00",
                            "place": "CLEVELAND,CUYAHOGA,OHIO,UNITED STATES",
                            "placeCd": "USCLE",
                            "transportMode": "",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "",
                            "statusDesc": "",
                            "statusDescEn": "Customs Released(Port of Discharge)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-02 09:10:00",
                            "place": "LONG BEACH,LOS ANGELES,CALIFORNIA,UNITED STATES",
                            "placeCd": "USLGB",
                            "transportMode": "",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "DCRL",
                            "statusDesc": "目的港海关放行",
                            "statusDescEn": "Carrier and Customs Released",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-02 09:10:00",
                            "place": "LONG BEACH,LOS ANGELES,CALIFORNIA,UNITED STATES",
                            "placeCd": "USLGB",
                            "transportMode": "",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "BDAR",
                            "statusDesc": "抵达卸货港",
                            "statusDescEn": "BOARD ARRIVE",
                            "vesselName": "COSCO SHIPPING PEONY",
                            "voyage": "038E",
                            "eventTime": "2026-07-03 15:34:00",
                            "place": "LONG BEACH,LOS ANGELES,CALIFORNIA,UNITED STATES",
                            "placeCd": "USLGB",
                            "transportMode": "VESSEL",
                            "isEstimate": false,
                            "sourceCd": "1"
                        },
                        {
                            "statusCd": "PDAR",
                            "statusDesc": "抵达目的地",
                            "statusDescEn": "PLACE OF DELIVERY ARRIVAL",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2026-07-06 08:00:00",
                            "place": "CLEVELAND,CUYAHOGA,OHIO,UNITED STATES",
                            "placeCd": "USCLE",
                            "transportMode": "",
                            "isEstimate": true,
                            "sourceCd": "1"
                        }
                    ]
                }
            ]
        }
    ]
}'

Responses

🟢200sucess
application/json
Bodyapplication/json

Example
{
    "code": "200",
    "type": "S",
    "message": null,
    "time": "2023-12-13 01:20:38"
}
Modified at 2026-10-18 09:17:22
Previous
Batch On-demand Request API
Next
China Terminal Data Support List
Built with