Carriers

TOPTRANS Tracking API & MCP

Query live TOPTRANS (toptrans, Czech Republic and Slovakia freight) status and scan history in a single synchronous request.

Overview & Quick Facts

PropertyValue
Carrier slug (?carrier=)toptrans
Brand aliasesToptrans CZ, TOPTRANS SK
CategoryRegional
Single-package REST endpointGET https://api.lastscanned.com/v1/track/{trackingNumber}
Batch REST endpointGET https://api.lastscanned.com/v1/track?numbers=...
MCP server (https://mcp.lastscanned.com)track_package, track_packages, list_carriers
Authentication & pricingAuthorization: Bearer lsk_live_... · 1 free keyless lookup/day per IP

Tracking Number Formats & Auto-Detection

PassRule / RegexCheck DigitExamples
Pass 1 (matches)nonenonenone
Pass 2 (mayMatch)nonenonenone

Pass ?carrier=toptrans so the number is routed here.

Synchronous GET Request & Normalized JSON Response

curl -s "https://api.lastscanned.com/v1/track/26123456789?carrier=toptrans" \
  -H "Authorization: Bearer $LASTSCANNED_API_KEY"
{
  "carrier": "toptrans",
  "trackingNumber": "26123456789",
  "status": "delivered",
  "statusDescription": "Zásilka doručena",
  "service": null,
  "deliveredAt": "2026-03-15T11:55:00Z",
  "deliveredAtLocal": "2026-03-15T12:55:00",
  "signedBy": null,
  "destination": null,
  "events": [
    {
      "timestamp": "2026-03-15T11:55:00Z",
      "localTime": "2026-03-15T12:55:00",
      "status": "delivered",
      "description": "Zásilka doručena",
      "location": "Bratislava",
      "code": null
    },
    {
      "timestamp": "2026-03-15T10:13:00Z",
      "localTime": "2026-03-15T11:13:00",
      "status": "out_for_delivery",
      "description": "Zásilka se rozváží",
      "location": "Bratislava",
      "code": null
    },
    {
      "timestamp": "2026-03-08T15:56:00Z",
      "localTime": "2026-03-08T16:56:00",
      "status": "label_created",
      "description": "Přijata objednávka přepravy",
      "location": "Trenčín",
      "code": null
    }
  ]
}

Notes

  • Source: TOPTRANS's public tracking endpoint (server-rendered HTML). Eleven digits is shared with other carriers, so use ?carrier=toptrans.
  • Time zone: converted from Europe/Prague (Czech and Slovak depots share it). Descriptions are Czech.

On this page