Shipment On-demand Update API

POST

https://api.trackingeyes.com/api/oceanbill/timelyUpdateById

On-demand update is performed for already subscribed shipments (additional commercial agreement required), and the updated data is returned through the push API.

Batch on-demand update is supported, with a maximum of 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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.trackingeyes.com/api/oceanbill/timelyUpdateById?companyCode=&token=&orgCode=' \
--header 'Content-Type: application/json' \
--data '{
    "type": "SR",
    "batchId": "123456789",
    "data": [
        {
            "id": "1915644277908705300"
        },
        {
            "id": "1915299485228077000"
        }
    ]
}'

Responses

🟢200Success

application/json

Bodyapplication/json

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-10-18 08:21:45

Shipment Details Push API

Shipment Details Download API