Mainfreight Tracking API & MCP

Query live Mainfreight (mainfreight) package status and scan history in a single synchronous GET request or MCP tool call. Mainfreight numbers are not auto-detected: consignment references have no unique format, so pass ?carrier=mainfreight.

Overview & Quick FactsCopy Anchor Link

Why developers use lastscanned for MainfreightCopy Anchor Link

• Current status of a freight consignment from Mainfreight's public tracker, without a Mainfreight login.
• Journey and service: the result carries the consignment's service type and the time its status was set.

Tracking Number Formats & Auto-DetectionCopy Anchor Link

Synchronous GET Request & Normalized JSON ResponseCopy Anchor Link

curlCopy Anchor Link

curl -s "https://api.lastscanned.com/v1/track/ABC1234567?carrier=mainfreight" \
  -H "Authorization: Bearer $LASTSCANNED_API_KEY"

JavaScript / TypeScript (fetch)Copy Anchor Link

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

MCP track_package tool callCopy Anchor Link

{
  "tool": "track_package",
  "arguments": {
    "tracking_number": "ABC1234567",
    "carrier": "mainfreight"
  }
}

Normalized TrackingResult JSON responseCopy Anchor Link

{
  "carrier": "mainfreight",
  "trackingNumber": "ABC1234567",
  "status": "in_transit",
  "statusDescription": "In Transit",
  "service": "AirAndOcean",
  "deliveredAt": null,
  "deliveredAtLocal": null,
  "signedBy": null,
  "destination": null,
  "events": [
    {
      "timestamp": "2026-10-25T21:30:00Z",
      "localTime": null,
      "status": "in_transit",
      "description": "In Transit",
      "location": "Auckland to Sydney",
      "code": null
    }
  ]
}

NotesCopy Anchor Link

• One event: the public tracker shows a status banner, not a list of scans, so events holds the current status.
• Written from the page's own scripts: the empty answer for an unknown number was checked live; the field names of a found consignment come from the page's code.

Related ResourcesCopy Anchor Link

• Live browser lookup tool: Track a Mainfreight package live on lastscanned.com/lookup/mainfreight
• Carrier hub: All supported carriers
• Regex & check digits: Tracking number formats & auto-detection
• AI support workflows: WISMO AI agents & synchronous tracking