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

Batch On-demand Request API

POST
https://api.trackingeyes.com/api/oceanbill/timelyUpdate
API integration package: Batch On-demand Request API + On-demand Request Push API
1.
This is not a subscription mode; shipments are requested on demand.
2.
Batch on-demand request is supported, with a maximum of 30 shipments per request.

Request

Query Params

Body Params application/json

Example
{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "localKey": null,
            "referenceNo": "SNLFSHJL32E3569",
            "carrierCd": "SINO",
            "blType": "BL",
            "extendNo": {
                "ctnrNo": "SNBU2285642"
            }
        },
        {
            "localKey": "A123456",
            "referenceNo": "CXDU1599297",
            "carrierCd": "ONE",
            "blType": "CN",
            "extendNo": null
        }
    ]
}

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/oceanbill/timelyUpdate?companyCode=&token=&orgCode=' \
--header 'Content-Type: application/json' \
--data '{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "localKey": null,
            "referenceNo": "SNLFSHJL32E3569",
            "carrierCd": "SINO",
            "blType": "BL",
            "extendNo": {
                "ctnrNo": "SNBU2285642"
            }
        },
        {
            "localKey": "A123456",
            "referenceNo": "CXDU1599297",
            "carrierCd": "ONE",
            "blType": "CN",
            "extendNo": null
        }
    ]
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": [
        {
            "batchId": "123456789",
            "requestId": "20250507143000",
            "localKey": null,
            "referenceNo": "SNLFSHJL32E3569",
            "carrierCd": "BLNO",
            "blType": "BL",
            "stateCode": "S",
            "message": null,
            "callTime": "2025-05-09 18:00:00"
        },
        {
            "batchId": "123456789",
            "requestId": "20250507143001",
            "localKey": "A123456",
            "referenceNo": "CXDU1599297",
            "carrierCd": "ONE",
            "blType": "CN",
            "stateCode": "S",
            "message": null,
            "callTime": "2025-05-09 18:00:00"
        }
    ]
}
Modified at 2026-10-18 08:22:41
Previous
Shipment Exception Alert Push API
Next
On-demand Request Push API
Built with