1. Ocean Cargo Tracking
Trackingeyes-API
🇺🇸 English
  • 🇨🇳 中文
  • 🇺🇸 English
  • Authentication
    • OAuth
      POST
    • Get Port Codes
      GET
    • Get Carrier Codes
      GET
  • Ocean Data API
    • Ocean Data
      • Ocean Support List
      • Ocean Status Code
      • Ocean Cargo Tracking
        • Ocean Tracking Subscribe
          POST
        • Ocean Tracking Push
          POST
        • Ocean Tracking Timely Update
          POST
        • Ocean Tracking Download
          GET
    • China Port Data
      • China Port List
      • China Port Subscription
      • China Port Push
      • China Port Download
    • Container Maritime Trajectory
      • DEMO
      • Container Maritime Trajectory
  • AI Ship Prediction
    • AI Ship Prediction Query
      GET
  • Overseas Data API
    • US Terminal Data
      • US Terminal Data Subscription
      • US Terminal Data Download
    • US Customs Clearance Data
      • US Customs Clearance Data Query
  • Air Data API
    • Air Support List
    • Air Status Code
    • Air Cargo Tracking
      • Air Tracking Subscribe
      • Air Tracking Push
      • Air Tracking Download
  1. Ocean Cargo Tracking

Ocean Tracking Timely Update

POST
https://api.trackingeyes.com/api/oceanbill/timelyUpdateById
1.
Update subscribed shipments by ID and return data via automatic full push.
2.
Supports batch timely updates; max 30 shipments per request.

Request

Query Params

Body Params application/json

Example
{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "id": 1915644277908705300
        },
        {
            "id": 1915299485228077000
        }
    ]
}

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 --request POST 'https://api.trackingeyes.com/api/oceanbill/timelyUpdateById?companyCode&token&orgCode' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "id": 1915644277908705300
        },
        {
            "id": 1915299485228077000
        }
    ]
}'

Responses

🟢200成功
application/json
Body

Example
{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": [
        {
            "id": 1915644277908705300,
            "batchId": "123456789",
            "requestId": "20250507164300",
            "stateCode": "S",
            "message": null,
            "callTime": "2025-05-09 18:00:00"
        },
        {
            "id": 1915299485228077000,
            "batchId": "123456789",
            "requestId": "20250507164301",
            "stateCode": "S",
            "message": null,
            "callTime": "2025-05-09 18:00:00"
        }
    ]
}
Modified at 2026-03-23 10:46:20
Previous
Ocean Tracking Push
Next
Ocean Tracking Download
Built with