JYExpress Tracking API & MCP
Query live JYExpress (jyexpress) package status and scan history in a single synchronous GET request or MCP tool call. JYExpress numbers share their shape with China Post and DHL numbers, so pass ?carrier=jyexpress.
Overview & Quick Facts
| Property | Value |
|---|---|
Carrier slug (?carrier=) | jyexpress |
| Brand aliases | JYExpress, JY Express, JY-Express |
| Category | Cross-border e-commerce parcels |
| Single-package REST endpoint | GET https://api.lastscanned.com/v1/track/{trackingNumber}?carrier=jyexpress |
| Batch REST endpoint | GET https://api.lastscanned.com/v1/track?numbers=...,...&carrier=jyexpress |
MCP server (https://mcp.lastscanned.com) | track_package, track_packages, list_carriers |
| Authentication & pricing | Authorization: Bearer lsk_live_... · 1 free keyless lookup/day per IP |
Tracking Number Formats & Auto-Detection
| Pass | Rule / Regex | Check Digit | Examples |
|---|---|---|---|
Pass 1 (matches) | none | none | none |
Pass 2 (mayMatch) | none | none | none |
JYExpress tracking numbers are mostly China Post S10 numbers (LN123456789CN, RS123456789CN) or 10 digits, and other carriers own those shapes, so always pass ?carrier=jyexpress. The tracker also accepts the shipper's reference number and the JY invoice number.
Synchronous GET Request & Normalized JSON Response
curl -s "https://api.lastscanned.com/v1/track/LN123456789CN?carrier=jyexpress" \
-H "Authorization: Bearer $LASTSCANNED_API_KEY"{
"carrier": "jyexpress",
"trackingNumber": "LN123456789CN",
"status": "delivered",
"statusDescription": "Delivered, Front Door/Porch",
"service": "广州EUB",
"deliveredAt": null,
"deliveredAtLocal": "2026-02-14T14:32:00",
"signedBy": null,
"destination": { "city": null, "state": null, "country": "US" },
"message": null,
"events": [
{
"timestamp": null,
"localTime": "2026-02-14T14:32:00",
"status": "delivered",
"description": "Delivered, Front Door/Porch",
"location": "TINLEY PARK, IL 60477",
"code": null
},
{
"timestamp": null,
"localTime": "2026-02-07T22:44:00",
"status": "in_transit",
"description": "收寄",
"location": "广州市邮政速递物流公司国际业务分公司",
"code": null
}
]
}Notes
- Scan wording: scans are in Chinese for the Chinese leg and in the destination post's English (USPS, DHL) for the rest.
- Time zone: scan times come with no zone and span China and the destination, so
localTimeis each scan's own clock time andtimestampanddeliveredAtarenull. - Batches: up to 20 numbers go to JYExpress in one request.
- Platform: JYExpress runs the Hualei (华磊) tracker, which other Chinese forwarders also use.
Related Resources
- Regex & check digits: Tracking number formats & auto-detection