Carriers

CJ Logistics (CJ Korea Express / 대한통운) Tracking API & MCP

Query live CJ Logistics (cjlogistics, CJ대한통운 domestic parcel) package status and scan history in a single synchronous GET request or MCP tool call. Scan times are Korean local time and come back with UTC timestamps. Pass ?carrier=cjlogistics: CJ's 10- and 12-digit waybills share their shape with DHL Express and FedEx.

Overview & Quick Facts

PropertyValue
Carrier slug (?carrier=)cjlogistics
Brand & service aliasesCJ Logistics, CJ대한통운, CJ Korea Express, 대한통운 택배
CategorySouth Korea domestic parcel
Single-package REST endpointGET https://api.lastscanned.com/v1/track/{trackingNumber}?carrier=cjlogistics
Batch REST endpointGET https://api.lastscanned.com/v1/track?numbers=123456789012,123456789012&carrier=cjlogistics
MCP server (https://mcp.lastscanned.com)track_package, track_packages, list_carriers (claude mcp add --transport http lastscanned https://mcp.lastscanned.com)
Authentication & pricingAuthorization: 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) · HTTP 402 Stripe MPP ($0.50 for 25-number lsk_pack_ key or $0.02/number in USDC on Tempo)

Tracking Number Formats & Auto-Detection (matches vs ?carrier=cjlogistics)

PassRule / RegexCheck DigitExamples
Pass 1 (matches)None——
Pass 2 (mayMatch)/^(\d{10}|\d{12})$/—6811234567, 612345678901
Explicit (?carrier=cjlogistics)Any CJ waybill—123456789012

When is ?carrier=cjlogistics optional vs required?

  • Required: CJ waybills are plain 10- or 12-digit runs, which FedEx and DHL also use, so auto-detection never picks CJ on its own. Always pass ?carrier=cjlogistics for these numbers.

Synchronous GET Request & Normalized JSON Response

curl -s "https://api.lastscanned.com/v1/track/123456789012?carrier=cjlogistics" \
  -H "Authorization: Bearer $LASTSCANNED_API_KEY"
const res = await fetch("https://api.lastscanned.com/v1/track/123456789012?carrier=cjlogistics", {
  headers: { Authorization: `Bearer ${process.env.LASTSCANNED_API_KEY}` },
});
const pkg = await res.json();
console.log(pkg.status, pkg.events[0]);

MCP track_package tool call:

{
  "tool": "track_package",
  "arguments": { "tracking_number": "123456789012", "carrier": "cjlogistics" }
}

Normalized TrackingResult response:

{
  "carrier": "cjlogistics",
  "trackingNumber": "123456789012",
  "status": "delivered",
  "statusDescription": "배송완료 고객님의 상품이 배송완료 되었습니다.",
  "service": null,
  "deliveredAt": "2026-10-21T07:05:00Z",
  "deliveredAtLocal": "2026-10-21T16:05:00",
  "signedBy": null,
  "destination": null,
  "events": [
    {
      "timestamp": "2026-10-21T07:05:00Z",
      "localTime": "2026-10-21T16:05:00",
      "status": "delivered",
      "description": "배송완료 고객님의 상품이 배송완료 되었습니다.",
      "location": "서울동작",
      "code": null
    },
    {
      "timestamp": "2026-10-20T16:42:00Z",
      "localTime": "2026-10-21T01:42:00",
      "status": "in_transit",
      "description": "간선하차 접수하신 물품이 중계점에 도착하였습니다",
      "location": "곤지암Hub",
      "code": null
    }
  ]
}

Notes

  • Source: the two JSON endpoints behind CJ's own tracker page (trace.cjlogistics.com), no account or key. A number CJ does not know returns not_found.
  • Korean wording: description is CJ's own Korean text (a step name followed by its sentence). status is mapped from the Korean step names such as 집화 (pickup), 간선상차/하차 (linehaul), 배송출발 (out for delivery) and 배송완료 (delivered).
  • Times: every scan is in South Korea, so each event carries timestamp in UTC computed from Asia/Seoul.

Poste Italiane Tracking API & MCP

Track Poste Italiane parcels and mail (S10 numbers ending IT) via synchronous REST GET or MCP. Normalized JSON status and scan history, no carrier credentials required.

Yamato Transport (Kuroneko Yamato / ヤマト運輸) Tracking API & MCP

Track Yamato Transport (Kuroneko Yamato, TA-Q-BIN, ヤマト運輸) parcels in Japan via synchronous REST GET or MCP. Normalized JSON status and scan history with Asia/Tokyo timestamps, no carrier credentials required.

On this page

Overview & Quick FactsTracking Number Formats & Auto-Detection (matches vs ?carrier=cjlogistics)When is ?carrier=cjlogistics optional vs required?Synchronous GET Request & Normalized JSON ResponseNotesRelated Resources