CNE Express Tracking API & MCP

Query live CNE Express (cne, 递一国际物流) cross-border package status, scan history, and destination last-mile handoff numbers in a single synchronous GET request or MCP tool call. lastscanned auto-detects 13-character 3A5V… waybills in Pass 1 and returns a normalized TrackingResult JSON payload—without requiring a CNE merchant account or API signature secret.

Overview & Quick FactsCopy Anchor Link

Why developers use lastscanned for CNE Express instead of direct requestsCopy Anchor Link

• Avoid CNE WebAssembly MD5 request signing & ReturnValue: -5555 IP blocks: Direct requests from serverless functions (Cloudflare Workers, Vercel, AWS Lambda) to wapi.cne.com require computing custom MD5 request signatures (signature header and md5 body digest) and get blocked for hours with ReturnValue: -5555 after just 15–20 lookups from a shared datacenter IP. Calling GET https://api.lastscanned.com/v1/track/:number returns clean JSON in one fetch().
• Automatic last-mile carrier & exchange number extraction: Once a CNE parcel clears customs and is handed to a local carrier (such as USPS, Royal Mail, UniUni, Evri, or DHL), lastscanned extracts both lastMileSupplier.enName and Response_Info.transNbr into top-level message (e.g. "Handed to Royal Mail as WG123456789GB" or "Handed to USPS as 9261290312839104827163").

Tracking Number Formats & Auto-Detection (matches vs mayMatch)Copy Anchor Link

CNE Express is evaluated twenty-seventh (#27) in lastscanned's two-pass detector:

When is ?carrier=cne optional vs required?Copy Anchor Link

• Optional (auto-detected): All 13-character 3A5V + 9-digit CNE waybill numbers auto-detect in Pass 1.
• Required (?carrier=cne): Destination carrier tracking numbers (transNbr) or merchant reference numbers that you want to query inside CNE's tracking system rather than the destination carrier.

Synchronous GET Request & Normalized JSON ResponseCopy Anchor Link

curlCopy Anchor Link

curl -s "https://api.lastscanned.com/v1/track/3A5V700123456" \
  -H "Authorization: Bearer $LASTSCANNED_API_KEY"

JavaScript / TypeScript (fetch)Copy Anchor Link

const res = await fetch("https://api.lastscanned.com/v1/track/3A5V700123456", {
  headers: { Authorization: `Bearer ${process.env.LASTSCANNED_API_KEY}` },
});
const pkg = await res.json();
console.log(pkg.status, pkg.message, pkg.events[0]);

MCP track_package tool callCopy Anchor Link

{
  "tool": "track_package",
  "arguments": {
    "tracking_number": "3A5V700123456"
  }
}

Normalized TrackingResult JSON responseCopy Anchor Link

{
  "carrier": "cne",
  "trackingNumber": "3A5V700123456",
  "status": "delivered",
  "statusDescription": "Delivered",
  "service": null,
  "deliveredAt": "2026-10-24T13:58:00Z",
  "deliveredAtLocal": "2026-10-24T14:58:00",
  "signedBy": null,
  "destination": {
    "city": null,
    "state": null,
    "country": "GB"
  },
  "message": "Handed to Royal Mail as WG849201736GB",
  "events": [
    {
      "timestamp": null,
      "localTime": "2026-10-24T14:58:00",
      "status": "delivered",
      "description": "Delivered",
      "location": "London",
      "code": "3"
    },
    {
      "timestamp": null,
      "localTime": "2026-10-22T09:30:00",
      "status": "in_transit",
      "description": "Custom clearance completed",
      "location": "London",
      "code": "1"
    },
    {
      "timestamp": "2026-10-19T14:29:14Z",
      "localTime": "2026-10-19T22:29:14",
      "status": "in_transit",
      "description": "Departed from sorting center",
      "location": "Shanghai",
      "code": "1"
    },
    {
      "timestamp": "2026-10-18T07:10:00Z",
      "localTime": "2026-10-18T15:10:00",
      "status": "label_created",
      "description": "Parcel Information Received",
      "location": null,
      "code": "0"
    }
  ]
}

Chaining Last-Mile Handoffs (message) & Status NotesCopy Anchor Link

• Handoff number in message: When CNE assigns a destination carrier number (transNbr), message formats it as "Handed to <Carrier> as <TrackingNumber>". If the destination carrier is one of the 31 supported carriers (such as USPS, Canada Post, UniUni, or DHL), you can pass that secondary number straight to GET /v1/track/:number.
• Timestamps & status codes: Origin scans in China (CN.<city>) and top-level deliveryDate are converted from Asia/Shanghai (UTC+8) into UTC (timestamp / deliveredAt), while overseas scan rows retain their local facility wall clock in localTime. CNE numeric state codes (0 not delivered, 1/2 shipping, 3 delivered, 4 timeout, 5 customs inspection, 6 invalid address, 7 lost, 8 returned, 9 exception, 10 destroyed) are preserved in events[].code.

Related ResourcesCopy Anchor Link

• Live browser lookup tool: Track a CNE Express package live on lastscanned.com/lookup/cne
• Carrier hub: All 31 supported carriers
• Regex & check digits: Tracking number formats & auto-detection
• AI support workflows: WISMO AI agents & synchronous tracking