SunYou (SYPost) Tracking API & MCP

Query live SunYou / SYPost (sunyou, 顺友物流) 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 SY… waybills in Pass 1 and returns a normalized TrackingResult JSON payload—without requiring a SunYou merchant account or API key.

Overview & Quick FactsCopy Anchor Link

Why developers use lastscanned for SunYou / SYPostCopy Anchor Link

• Clean JSON instead of SYPost JSONP callbacks: SunYou's public tracker (sypost.net) wraps responses in JSONP searchCallback({...}) payloads with oldest-first scan arrays and mislabels destination-country scans (status 2xx in the US, UK, or Australia) with China's "+08:00" timezone offset. lastscanned unwraps the payload, reverses the scan timeline to newest-first, filters out bogus +08:00 offsets on non-UTC+8 destination scans, and maps SunYou's displayStatus and eventCode values into the 7 standard statuses.
• Automatic last-mile carrier & exchange number extraction: Once SunYou hands an AliExpress or marketplace parcel to a destination carrier (USPS, Royal Mail, SpeedX, UniUni, Australia Post), lastscanned extracts carrierName and the secondary trackingNumber into top-level message (e.g. "Handed to USPS as 9261290312839104827163").

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

SunYou is evaluated twenty-eighth (#28) in lastscanned's two-pass detector:

Disambiguating SunYou (SY…) vs UPU S10 numbersCopy Anchor Link

• Zero collision with UPU S10 international numbers: Standard UPU S10 numbers end with a 2-letter ISO country code (EA123456785US, EE123456785CA, UV123456785YP), whereas SunYou's 13-character numbers put the 4 letters at the beginning (SY + 2 letters + 9 digits). All SY[A-Z]{2}\d{9} numbers auto-detect in Pass 1 without ?carrier=.
• When ?carrier=sunyou is required: If you are querying a non-SY partner tracking number (LP…, SYB… reference) directly against SunYou.

Synchronous GET Request & Normalized JSON ResponseCopy Anchor Link

curlCopy Anchor Link

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

JavaScript / TypeScript (fetch)Copy Anchor Link

const res = await fetch("https://api.lastscanned.com/v1/track/SYUS016825135", {
  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": "SYUS016825135"
  }
}

Normalized TrackingResult JSON responseCopy Anchor Link

{
  "carrier": "sunyou",
  "trackingNumber": "SYUS016825135",
  "status": "delivered",
  "statusDescription": "Delivered, In/At Mailbox",
  "service": null,
  "deliveredAt": null,
  "deliveredAtLocal": "2026-10-25T13:18:00",
  "signedBy": null,
  "destination": {
    "city": null,
    "state": null,
    "country": "US"
  },
  "message": "Handed to USPS as 9200190312839104827163",
  "events": [
    {
      "timestamp": null,
      "localTime": "2026-10-25T13:18:00",
      "status": "delivered",
      "description": "Delivered, In/At Mailbox",
      "location": "AUSTIN, TX, United States",
      "code": "Delivered_Mailbox"
    },
    {
      "timestamp": null,
      "localTime": "2026-10-25T07:10:00",
      "status": "out_for_delivery",
      "description": "Out for Delivery",
      "location": "AUSTIN, TX, United States",
      "code": "OutForDelivery"
    },
    {
      "timestamp": "2026-10-19T15:30:00Z",
      "localTime": "2026-10-19T23:30:00",
      "status": "in_transit",
      "description": "Departed Sunyou Facility, Carrier Tracking Number: 9200190312839104827163",
      "location": "Shenzhen, China",
      "code": "Dispatch"
    },
    {
      "timestamp": "2026-10-18T02:14:00Z",
      "localTime": "2026-10-18T10:14:00",
      "status": "label_created",
      "description": "Pre-Shipment Info Sent to Destination",
      "location": "China",
      "code": "PreAlert"
    }
  ]
}

Raw status & event codes: events[].code preserves SunYou's milestone identifier ("PreAlert", "InboundScan", "Dispatch", "PortArrival", "ClearanceSuccessed_Export", "PortDeparture", "DestinationAirPortArrival", "ClearanceSuccessed", "HandoverLastMile", "OutForDelivery", "DeliveryFail_<reason>", "Delivered", "Delivered_Mailbox", "Returned").

Related ResourcesCopy Anchor Link

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