获取物流轨迹

查询指定单号的物流轨迹。

接口地址: GET /api/track-points/{id}

所需权限 (Scope): track-points:read

请求

参数:

名称	类型	是否必填	描述
id	string	是	需查询物流的包裹唯一 ID 或跟踪号。

响应

返回包含 物流响应对象 的 操作结果。

成功响应示例

{
  "Data": {
    "TrackingNumber": "TRACK123456",
    "Status": "Delivered",
    "Events": [
      {
        "TimeLocal": "2026-03-13T15:36:22",
        "TimeUtc": "2026-03-13T19:36:22Z",
        "TimezoneOffset": "-04:00",
        "CarrierEventCode": "01",
        "Description": "Delivered, In/At Mailbox",
        "Location": {
          "CountryCode": "US",
          "City": "DURHAM",
          "Province": "NC",
          "Postcode": "27713"
        }
      },
      {
        "TimeLocal": "2026-03-13T06:40:17",
        "TimeUtc": "2026-03-13T10:40:17Z",
        "TimezoneOffset": "-04:00",
        "CarrierEventCode": "OF",
        "Description": "Out for Delivery",
        "Location": {
          "CountryCode": "US",
          "City": "DURHAM",
          "Province": "NC",
          "Postcode": "27713"
        }
      },
      {
        "TimeLocal": "2026-03-13T06:29:17",
        "TimeUtc": "2026-03-13T10:29:17Z",
        "TimezoneOffset": "-04:00",
        "CarrierEventCode": "07",
        "Description": "Arrived at Post Office",
        "Location": {
          "CountryCode": "US",
          "City": "DURHAM",
          "Province": "NC",
          "Postcode": "27709"
        }
      },
      {
        "TimeLocal": "2026-03-12T10:09:55",
        "TimeUtc": "2026-03-12T14:09:55Z",
        "TimezoneOffset": "-04:00",
        "CarrierEventCode": "10",
        "Description": "Arrived at USPS Regional Destination Facility",
        "Location": {
          "CountryCode": "US",
          "City": "RALEIGH NC DISTRIBUTION CENTER",
          "Province": null,
          "Postcode": null
        }
      },
      {
        "TimeLocal": "2026-03-11T00:00:00",
        "TimeUtc": null,
        "TimezoneOffset": null,
        "CarrierEventCode": "NT",
        "Description": "In Transit to Next Facility",
        "Location": {
          "CountryCode": "US",
          "City": null,
          "Province": null,
          "Postcode": null
        }
      },
      {
        "TimeLocal": "2026-03-10T21:10:40",
        "TimeUtc": "2026-03-11T04:10:40Z",
        "TimezoneOffset": "-07:00",
        "CarrierEventCode": "10",
        "Description": "Arrived at USPS Regional Origin Facility",
        "Location": {
          "CountryCode": "US",
          "City": "CITY OF INDUSTRY CA DISTRIBUTION",
          "Province": null,
          "Postcode": null
        }
      },
      {
        "TimeLocal": "2026-03-10T19:55:40",
        "TimeUtc": "2026-03-11T02:55:40Z",
        "TimezoneOffset": "-07:00",
        "CarrierEventCode": "OA",
        "Description": "Accepted at USPS Origin Facility",
        "Location": {
          "CountryCode": "US",
          "City": "WALNUT",
          "Province": "CA",
          "Postcode": "91789"
        }
      },
      {
        "TimeLocal": "2026-03-09T19:36:34",
        "TimeUtc": "2026-03-10T02:36:34Z",
        "TimezoneOffset": "-07:00",
        "CarrierEventCode": "GX",
        "Description": "Shipping Label Created, USPS Awaiting Item",
        "Location": {
          "CountryCode": "US",
          "City": "WALNUT",
          "Province": "CA",
          "Postcode": "91789"
        }
      }
    ]
  },
  "Succeeded": true,
  "Error": null,
  "CapturedValues": {}
}