1. China Terminal Data
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
        POST
      • China Terminal Data Details Push API
        POST
      • China Terminal Data Details Download API
        GET
    • 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
    • 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. China Terminal Data

China Terminal Data Subscription API

POST
https://api.trackingeyes.com/api/portdata/batchBooking
1.
The number of subscriptions per request is limited to 30.
2.
Enhanced edition users must upload "type": "1".
3.
When subscribing to port area data with a container number, the etd parameter is required.
4.
⭐=Recently added field.

Request

Query Params

Body Params application/json

Example
[
    {
        "localKey": "",
        "referenceNo": "6404722375",
        "blType": "BL",
        "portcd": "CNYTN",
        "ieId": "E",
        "type": "0",
        "customerService": "",
        "extendNo": {
            "etd": "2026-10-18"
        },
        "remark": ""
    }
]

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/api/portdata/batchBooking?companyCode=&token=&orgCode=' \
--header 'Content-Type: application/json' \
--data '[
    {
        "localKey": "",
        "referenceNo": "6404722375",
        "blType": "BL",
        "portcd": "CNYTN",
        "ieId": "E",
        "type": "0",
        "customerService": "",
        "extendNo": {
            "etd": "2026-10-18"
        },
        "remark": ""
    }
]'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": 200,
    "codeDesc": "success",
    "message": "",
    "result": [
        {
            "referenceNo": "6404722375",
            "blType": "BL",
            "portcd": "CNYTN",
            "ieId": "E",
            "customerService": "",
            "extendNo": "{\"etd\":\"2026-10-18\"}",
            "remark": "",
            "id": "1876107834987515904",
            "localKey": "",
            "itemCode": 200,
            "itemCodeDesc": "success",
            "itemMessage": ""
        }
    ]
}
Modified at 2026-10-18 09:19:36
Previous
China Terminal Data Support List
Next
China Terminal Data Details Push API
Built with