Carriers
YDH Tracking API & MCP
Query live YDH (ydh) package status and scan history in a single synchronous GET request or MCP tool call. lastscanned auto-detects numbers shaped YDH + 10 digits + 2 letters.
Overview & Quick Facts
| Property | Value |
|---|---|
Carrier slug (?carrier=) | ydh |
| Brand & service aliases | YDH, YDH Express, YDH Cross Border, Yida (義達), ydhex.com |
| Category | Chinese cross-border e-commerce forwarder |
| Single-package REST endpoint | GET https://api.lastscanned.com/v1/track/{trackingNumber} |
| Batch REST endpoint | GET https://api.lastscanned.com/v1/track?numbers=... |
MCP server (https://mcp.lastscanned.com) | track_package, track_packages, list_carriers (claude mcp add --transport http lastscanned https://mcp.lastscanned.com) |
| Authentication & pricing | Authorization: Bearer lsk_live_... · 1 free keyless lookup/day per IP · Free tier (5 unique numbers/day, $0) · Pro ($4.99/mo for 1,000 unique numbers, unlimited re-polls, $0.015/extra) |
Tracking Number Formats & Auto-Detection
| Pass | Rule / Regex | Examples |
|---|---|---|
Pass 1 (matches) | /^YDH\d{10}[A-Z]{2}$/ | YDH0004849752AZ, YDH3001564927YQ |
Pass 2 (mayMatch) | None | n/a |
YDH only claims its own YDH… shape, so ?carrier=ydh is normally not needed.
Synchronous GET Request & Normalized JSON Response
curl
curl -s "https://api.lastscanned.com/v1/track/YDH0004849752AZ" \
-H "Authorization: Bearer $LASTSCANNED_API_KEY"MCP track_package tool call
{
"tool": "track_package",
"arguments": { "tracking_number": "YDH0004849752AZ" }
}Normalized TrackingResult JSON response
{
"carrier": "ydh",
"trackingNumber": "YDH0004849752AZ",
"status": "delivered",
"statusDescription": "配達完了",
"service": null,
"deliveredAt": null,
"deliveredAtLocal": "2023-08-01T13:27:01",
"signedBy": null,
"destination": { "city": null, "state": null, "country": "ES" },
"message": null,
"events": [
{
"timestamp": null,
"localTime": "2023-08-01T13:27:01",
"status": "delivered",
"description": "配達完了",
"location": null,
"code": null
},
{
"timestamp": null,
"localTime": "2023-07-28T20:47:28",
"status": "in_transit",
"description": "Shipped",
"location": null,
"code": null
},
{
"timestamp": null,
"localTime": "2023-07-22T22:52:43",
"status": "in_transit",
"description": "貨物お預かり",
"location": "SHENZHEN",
"code": null
},
{
"timestamp": null,
"localTime": "2023-07-22T08:58:17",
"status": "label_created",
"description": "情報お預かり",
"location": null,
"code": null
}
]
}Notes
- Source: the
track.ydhex.comquery form (server-rendered HTML), read directly from the Worker; no bot wall. - Wording: scan text is whatever YDH prints, a mix of Chinese, Japanese and English.
statusis derived from it, anddescriptionis passed through as is. - Times: scans print local time with no zone, so only
localTimeis set (timestampisnull). - Unknown numbers: YDH answers "no record", returned as a
404 not_found.
Related Resources
- Carrier hub: All supported carriers
- Regex & check digits: Tracking number formats & auto-detection
- AI support workflows: WISMO AI agents & synchronous tracking
Hermes Germany Tracking API & MCP
Track Hermes Germany parcels (myhermes.de Sendungsverfolgung) via synchronous REST GET or MCP. Normalized JSON status and scan history, no carrier credentials required.
Equick China Tracking API & MCP
Track Equick China (EQK… cross-border waybills) via synchronous REST GET or MCP. Normalized JSON status and scan history, no carrier credentials required.