Trackingeyes-API
🇨🇳 中文
  • 🇨🇳 中文
  • 🇺🇸 English
  1. 海运跟踪
Trackingeyes-API
🇨🇳 中文
  • 🇨🇳 中文
  • 🇺🇸 English
  • 操作指南
    • 主要接口
    • 获取密钥
    • 常见问题
  • 通用接口
    • 获取token
      POST
    • 获取港口支持代码
      GET
    • 获取船东支持代码
      GET
  • 海运数据接口
    • 海运数据
      • DEMO
      • 海运支持清单
      • 海运状态码
      • 海运跟踪
        • 批量运单订阅接口
          POST
        • 推送运单动态接口
          POST
        • 运单及时更新接口
          POST
        • 下载运单详情接口
          GET
      • 及时请求
        • 批量及时请求接口
        • 及时请求推送接口
    • 港区数据
      • 中国港区支持清单
      • 中国港区数据订阅接口
      • 中国港区数据推送接口
      • 中国港区数据下载接口
    • 集装箱轨迹
      • DEMO
      • 集装箱轨迹接口
    • 船舶计划
      • 口岸支持清单
      • 船舶计划查询接口
  • 船舶AIS接口
    • DEMO
    • 船舶轨迹
      • 单船搜索接口
      • 船舶定位接口
      • 船舶历史挂港接口
      • 船舶轨迹接口
    • 电子围栏
      • 电子围栏查询接口
  • AI船舶预测
    • DEMO
    • AI船舶挂港预测接口
      GET
  • 船期表接口
    • 港到港船期表
      • DEMO
      • 船期支持清单
      • 港到港船期查询接口
      • 船期分页推送接口
      • 港到港船期查询接口2.0
      • 港到港船期分页推送接口2.0
    • 航线表定路径
      • 航线表定路径接口
    • 航次挂靠路径
      • 航次挂靠路径支持清单
      • 航次挂靠路径查询接口
      • 船舶船期分页下载接口
  • 电商运价接口
    • DEMO
    • 船东电商运价
      • 运价支持清单
      • 运价查询接口
  • 空运数据接口
    • DEMO
    • 空运支持清单
    • 空运状态码
    • 空运跟踪
      • 批量运单订阅接口
      • 推送运单动态接口
      • 批量运单下载接口
  • 陆运数据接口
    • EIR(电子设备交接单)
      • EIR支持清单
      • EIR获取接口
    • 场站数据
      • 场站支持清单
      • 场站数据订阅接口
      • 场站数据推送接口
    • 车辆GPS
      • DEMO
      • 车辆定位接口
      • 车辆轨迹接口
      • 车辆路线规划接口
  • 关务数据接口
    • 报关状态
      • 报关状态代码表
      • 报关状态订阅接口
      • 报关状态推送接口
      • 下载报关状态接口
    • 舱单数据
      • 舱单数据订阅接口
      • 舱单数据推送接口
      • 下载舱单数据接口
  • 海外数据接口
    • 全球码头数据
      • 全球码头支持清单
      • 全球码头数据订阅接口
      • 全球码头数据推送接口
      • 全球码头数据下载接口
    • 美国清关状态
      • 清关状态代码
      • 清关海运支持清单
      • 美国清关数据查询接口
  • 快递数据接口
    • 国家、地区ISO Alpha-3代码表
    • 主状态代码表
    • 子状态代码表
    • 承运商代码表
    • 承运商集团表
    • 特殊承运人代码表
    • 快递数据订阅接口
    • 快递数据推送接口
    • 快递数据下载接口
  • 其他数据接口
    • 通用港杂费
      • 港杂费代码清单
      • 通用港杂费查询接口
    • 操作时间
      • 操作时间查询接口
  1. 海运跟踪

下载运单详情接口

GET
https://api.trackingeyes.com/api/oceanbill/oceanBill
1.接口仅获取单个运单详情,不支持批量下载。
2.调用次数限制:一分钟60次。
3.所有的时间字段都是字符串类型,格式为 "yyyy-MM-dd HH:mm:ss", 如果时间没有值则为空字符串""。

Request

Query Params

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 GET 'https://api.trackingeyes.com/api/oceanbill/oceanBill?companyCode&token&orgCode&billId'

Responses

🟢200成功
application/json
Body

Example
{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": {
        "id": "2014229855069958146",
        "referenceNo": "TGBU7178978",
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "blNo": "",
        "bkgNo": "",
        "ctnrNo": "",
        "carrierCd": "ZIM",
        "carrier": "以星综合航运有限公司",
        "vesselName": "MSC UBERTY VIII",
        "voyage": "GE602E",
        "plrCd": "",
        "plr": "",
        "polCd": "CNNGB",
        "pol": "NINGBO (ZJ), CHINA. PEOPLE'S REPUBLIC",
        "podCd": "",
        "pod": "",
        "pldCd": "",
        "pld": "",
        "cyOpenTime": "",
        "cyCutOffTime": "",
        "dlptTime": "2026-01-21 23:51:00",
        "etd": "2026-01-22 08:00:00",
        "eta": "",
        "ata": "",
        "aisATD": "2026-01-22 09:00:42",
        "aisATA": "",
        "aisETA": "",
        "firstETA": "",
        "etaPld": "",
        "ataPld": "",
        "dschTime": "",
        "endTrackTime": "",
        "firstUpdateTime": "2026-01-22 15:04:47",
        "dataUpdateTime": "2026-01-22 15:25:42",
        "endStatus": "",
        "trackStatus": "跟踪中",
        "trackStatusCd": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2026-01-22 14:53:15",
        "status": "S",
        "errorDes": "",
        "ctnrInfos": [
            {
                "ctnrNo": "TGBU7178978",
                "sealNo": "",
                "ctnrSize": "40",
                "ctnrType": "HQ",
                "pkgs": "",
                "gwgt": "",
                "vgm": "",
                "currentStatusCd": "DLPT",
                "currentStatus": "Departure from Port of Loading",
                "currentStatusTime": "2026-01-22 08:30:00",
                "currentPlaceCd": "CNNGB",
                "currentPlace": "GANGJI TERMINAL,NINGBO,CHINA",
                "isRolled": "",
                "ctnrStatus": [
                    {
                        "id": "2014232760204292102",
                        "statusCd": "DLPT",
                        "statusDesc": "离港",
                        "statusDescEn": "Departure from Port of Loading",
                        "vesselName": "MSC UBERTY VIII",
                        "voyage": "GE602E",
                        "eventTime": "2026-01-22 08:30:00",
                        "place": "GANGJI TERMINAL,NINGBO,CHINA",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "sourceCd": "2",
                        "isEstimate": false
                    },
                    {
                        "id": "2014232760204292101",
                        "statusCd": "LOBD",
                        "statusDesc": "装船",
                        "statusDescEn": "Loaded on Board at Port of Loading",
                        "vesselName": "MSC UBERTY VIII",
                        "voyage": "GE602E",
                        "eventTime": "2026-01-22 02:31:00",
                        "place": "GANGJI TERMINAL,NINGBO,CHINA",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "sourceCd": "2",
                        "isEstimate": false
                    },
                    {
                        "id": "2014237046296440833",
                        "statusCd": "TMPS",
                        "statusDesc": "码头放行",
                        "statusDescEn": "Terminal Release",
                        "vesselName": "MSC UBERTY VIII",
                        "voyage": "GE602E",
                        "eventTime": "2026-01-19 23:09:51",
                        "place": "GANGJI TERMINAL,NINGBO,CHINA",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "sourceCd": "2",
                        "isEstimate": false
                    },
                    {
                        "id": "2014237046296440832",
                        "statusCd": "PASS",
                        "statusDesc": "海关放行",
                        "statusDescEn": "Customs Release",
                        "vesselName": "MSC UBERTY VIII",
                        "voyage": "GE602E",
                        "eventTime": "2026-01-19 20:28:32",
                        "place": "GANGJI TERMINAL,NINGBO,CHINA",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "sourceCd": "2",
                        "isEstimate": false
                    },
                    {
                        "id": "2014232760204292097",
                        "statusCd": "FCGI",
                        "statusDesc": "重箱返场/入货",
                        "statusDescEn": "Cargo Received from Yard",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2026-01-18 18:53:00",
                        "place": "NINGBO (ZJ), CHINA. PEOPLE'S REPUBLIC",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "id": "2014232760204292098",
                        "statusCd": "GITM",
                        "statusDesc": "起运港进场",
                        "statusDescEn": "Gate In to POL Terminal",
                        "vesselName": "MSC UBERTY VIII",
                        "voyage": "GE602E",
                        "eventTime": "2026-01-18 18:53:00",
                        "place": "GANGJI TERMINAL,NINGBO,CHINA",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "sourceCd": "2",
                        "isEstimate": false
                    },
                    {
                        "id": "2014232760204292096",
                        "statusCd": "STSP",
                        "statusDesc": "提空箱",
                        "statusDescEn": "Empty container dispatched from inland point to Customer",
                        "vesselName": "MSC UBERTY VIII",
                        "voyage": "3/E",
                        "eventTime": "2026-01-14 19:50:00",
                        "place": "NINGBO (ZJ), CHINA. PEOPLE'S REPUBLIC",
                        "placeCd": "CNNGB",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    }
                ]
            }
        ],
        "carriges": [
            {
                "id": "2014232761965899776",
                "sno": 1,
                "polCd": "CNNGB",
                "polNameEn": "NINGBO",
                "polNameCn": "宁波",
                "podCd": "",
                "podNameEn": "",
                "podNameCn": "",
                "etd": "2026-01-21 23:51:00",
                "atd": "2026-01-21 23:51:00",
                "eta": "",
                "ata": "",
                "vesselName": "MSC UBERTY VIII",
                "voy": "3/E",
                "type": "",
                "aisAtd": "2026-01-22 09:00:42",
                "aisAta": "",
                "aisEta": ""
            }
        ],
        "oceanNodes": [
            {
                "stateCode": "STSP",
                "stateDesc": "Empty Pickup",
                "stateDescCN": "提空箱",
                "place": "NINGBO (ZJ), CHINA. PEOPLE'S REPUBLIC",
                "placeCd": "CNNGB",
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-01-14 19:50:00",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 3
            },
            {
                "stateCode": "GITM",
                "stateDesc": "FGate In to Outbound Terminal",
                "stateDescCN": "起运港进场",
                "place": "GANGJI TERMINAL,NINGBO,CHINA",
                "placeCd": "CNNGB",
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-01-18 18:53:00",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 12
            },
            {
                "stateCode": "PASS",
                "stateDesc": "Customs Release",
                "stateDescCN": "海关放行",
                "place": "GANGJI TERMINAL,NINGBO,CHINA",
                "placeCd": "CNNGB",
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-01-19 20:28:32",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 13
            },
            {
                "stateCode": "LOBD",
                "stateDesc": "Loaded on Board at Port of Loading",
                "stateDescCN": "装船",
                "place": "GANGJI TERMINAL,NINGBO,CHINA",
                "placeCd": "CNNGB",
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-01-22 02:31:00",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 18
            },
            {
                "stateCode": "DLPT",
                "stateDesc": "Departure from Port of Loading",
                "stateDescCN": "离港",
                "place": "GANGJI TERMINAL,NINGBO,CHINA",
                "placeCd": "CNNGB",
                "count": 1,
                "total": 1,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "2026-01-22 08:30:00",
                "aisEstimateTime": "",
                "aisActualityTime": "2026-01-22 09:00:42",
                "number": 19
            },
            {
                "stateCode": "TSBA",
                "stateDesc": "Arrived at Transhipment Port",
                "stateDescCN": "中转抵港",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 20
            },
            {
                "stateCode": "TSDP",
                "stateDesc": "Departured from Transhipment Port",
                "stateDescCN": "中转开航",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 23
            },
            {
                "stateCode": "BDAR",
                "stateDesc": "Arrived at Port of Discharge",
                "stateDescCN": "目的港抵港",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 24
            },
            {
                "stateCode": "PDAR",
                "stateDesc": "Arrived on Place of Delivery",
                "stateDescCN": "抵达交货地",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 35
            },
            {
                "stateCode": "DSCH",
                "stateDesc": "Discharged at Port of Discharge",
                "stateDescCN": "目的港卸船",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 25
            },
            {
                "stateCode": "STCS",
                "stateDesc": "Gate Out from Inbound CY for Delivery to Consignee",
                "stateDescCN": "提重柜/提货",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 34
            },
            {
                "stateCode": "RCVE",
                "stateDesc": "Empty Container Returned",
                "stateDescCN": "还空箱",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 35
            },
            {
                "stateCode": "END",
                "stateDesc": "Tracking Finished",
                "stateDescCN": "结束跟踪",
                "place": "",
                "placeCd": "",
                "count": 0,
                "total": 0,
                "planTime": "",
                "estimateTime": "",
                "actualityTime": "",
                "aisEstimateTime": "",
                "aisActualityTime": "",
                "number": 36
            }
        ]
    }
}
Modified at 2026-01-23 07:37:37
Previous
运单及时更新接口
Next
批量及时请求接口
Built with