Carriers

PostNL Tracking API & MCP

Query live PostNL (postnl) package status and scan history in a single synchronous GET request or MCP tool call. lastscanned auto-detects 3S barcodes and UPU S10 numbers ending NL.

Overview & Quick Facts

PropertyValue
Carrier slug (?carrier=)postnl
Brand & service aliasesPostNL, TNT Post, jouw.postnl.nl Track & Trace
Single-package REST endpointGET https://api.lastscanned.com/v1/track/{trackingNumber}
Batch REST endpointGET https://api.lastscanned.com/v1/track?numbers=NUMBER1,NUMBER2
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

PassRuleCheck DigitExamples
Pass 1 (matches) — PostNL barcode3S + 4 letters + 7 to 9 digits—3SABCD1234567
Pass 1 (matches) — UPU S102 letters, 9 digits, NLUPU S10 mod-11RR123456785NL
Pass 2 (mayMatch)None——

Synchronous GET Request & Normalized JSON Response

curl

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

JavaScript / TypeScript (fetch)

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

Normalized TrackingResult JSON response

{
  "carrier": "postnl",
  "trackingNumber": "3SABCD1234567",
  "status": "in_transit",
  "statusDescription": "Parcel is being sorted",
  "service": null,
  "deliveredAt": null,
  "deliveredAtLocal": null,
  "signedBy": null,
  "destination": { "city": null, "state": null, "country": "NL" },
  "events": [
    {
      "timestamp": "2026-10-24T11:20:00Z",
      "localTime": "2026-10-24T13:20:00",
      "status": "in_transit",
      "description": "Parcel is being sorted",
      "location": null,
      "code": null
    }
  ]
}

Notes

  • The lookup uses the barcode with NL and no recipient postcode, which is what PostNL accepts without one; some parcels show fewer details that way.
  • A barcode PostNL has no record of comes back as not_found.

La Poste / Colissimo / Chronopost Tracking API & MCP

Track La Poste, Colissimo and Chronopost parcels and mail (13-character Colissimo numbers, S10 numbers ending FR) via synchronous REST GET or MCP. Normalized JSON status and scan history, no carrier credentials required.

Correos (Spain) Tracking API & MCP

Track Correos Spain parcels and mail (S10 numbers ending ES, PQ parcel codes) via synchronous REST GET or MCP. Normalized JSON status and scan history, no carrier credentials required.

On this page

Overview & Quick FactsTracking Number Formats & Auto-DetectionSynchronous GET Request & Normalized JSON ResponsecurlJavaScript / TypeScript (fetch)MCP track_package tool callNormalized TrackingResult JSON responseNotesRelated Resources