UniUni Tracking API & MCP

Query live UniUni (uniuni) package status and scan history across the US and Canada in a single synchronous GET request or MCP tool call. lastscanned auto-detects primary UUS… tracking numbers in Pass 1 and UR… / U9999… / U000… partner numbers in Pass 2, returning a normalized TrackingResult JSON payload—without requiring a UniUni enterprise shipper contract or webhook integration.

Overview & Quick FactsCopy Anchor Link

Why developers use lastscanned for UniUniCopy Anchor Link

• No merchant shipper account required: UniUni's shipper API is gated behind commercial onboarding for direct e-commerce merchants and 3PLs. With lastscanned, any application or AI support agent can track UniUni parcels immediately via GET /v1/track/:number.
• Translates opaque numeric state codes: UniUni's raw payload reports numeric state codes (190, 195, 200, 202, 203, 211, 213, 230, 1870) and oldest-first scan arrays. lastscanned reverses the timeline to newest-first and normalizes every state code into the 7 standard statuses.
• Seamless cross-border handoff target: Parcels originating on YunExpress, Yanwen, 4PX, or Cainiao frequently hand off to UniUni for North American final delivery.

Tracking Number Formats & Auto-Detection (matches vs mayMatch)Copy Anchor Link

UniUni is evaluated seventh (#7) in lastscanned's two-pass detector and uses both Pass 1 (matches) and Pass 2 (mayMatch):

When is ?carrier=uniuni optional vs required?Copy Anchor Link

• Optional (auto-detected in Pass 1): All UUS + 13–16 alphanumeric tracking numbers.
• Optional (auto-detected in Pass 2): UR + 12–20 digits, U9999 + 6–20 digits, and U000 + 6–20 digits. Because these formats sit in Pass 2 (mayMatch), they route to uniuni whenever no Pass 1 carrier claims the number.
• Required (?carrier=uniuni): Canadian / partner barcodes starting with GV… or JY… (such as GV2601…CAA0… or JY2601…CAA0…). Pass ?carrier=uniuni when querying these numbers.

Synchronous GET Request & Normalized JSON ResponseCopy Anchor Link

curlCopy Anchor Link

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

JavaScript / TypeScript (fetch)Copy Anchor Link

const res = await fetch("https://api.lastscanned.com/v1/track/UUS5BM1269395824723", {
  headers: { Authorization: `Bearer ${process.env.LASTSCANNED_API_KEY}` },
});
const pkg = await res.json();
console.log(pkg.status, pkg.statusDescription, pkg.deliveredAt);

MCP track_package tool callCopy Anchor Link

{
  "tool": "track_package",
  "arguments": {
    "tracking_number": "UUS5BM1269395824723"
  }
}

Normalized TrackingResult JSON responseCopy Anchor Link

{
  "carrier": "uniuni",
  "trackingNumber": "UUS5BM1269395824723",
  "status": "delivered",
  "statusDescription": "Delivered",
  "service": null,
  "deliveredAt": "2026-10-24T21:18:42Z",
  "deliveredAtLocal": "2026-10-24T14:18:42",
  "signedBy": null,
  "destination": {
    "city": "LOS ANGELES",
    "state": "CA",
    "country": "US"
  },
  "estimatedDelivery": null,
  "events": [
    {
      "timestamp": "2026-10-24T21:18:42Z",
      "localTime": "2026-10-24T14:18:42",
      "status": "delivered",
      "description": "Delivered",
      "location": "Los Angeles, CA",
      "code": "203"
    },
    {
      "timestamp": "2026-10-24T15:04:10Z",
      "localTime": "2026-10-24T08:04:10",
      "status": "out_for_delivery",
      "description": "Out for delivery",
      "location": "Los Angeles, CA",
      "code": "202"
    },
    {
      "timestamp": "2026-10-24T06:31:55Z",
      "localTime": "2026-10-23T23:31:55",
      "status": "in_transit",
      "description": "Arrived at UniUni facility",
      "location": "Los Angeles, CA",
      "code": "195"
    },
    {
      "timestamp": null,
      "localTime": "2026-10-21T05:46:35",
      "status": "label_created",
      "description": "Order received",
      "location": null,
      "code": "190"
    }
  ]
}

Raw status & state codes: events[].code preserves UniUni's numeric state code as a string ("190" / "1870" → label_created; "202" → out_for_delivery; "203" / "216" / "228" → delivered; "230" → returned; "206", "207", "209", "211" failed attempt, "215", "222", "229", "235" → exception; "195", "199", "200", "212", "213", "217", "220" → in_transit).

Carrier-Specific Status & Integration NotesCopy Anchor Link

• Timestamps (timestamp vs localTime): Physical hub and driver scans include both a Unix epoch (ts), local clock (localTime), and IANA timezone, populating both timestamp (UTC) and localTime. The initial electronic "Order received" scan (190/1870) carries no timezone, so timestamp is null and localTime holds the printed timestamp.
• Failed delivery attempts vs depot returns: State 211 (failed delivery attempt) maps to exception, whereas state 213 (parcel returned to local UniUni depot for redelivery) maps to in_transit and state 230 (returned to merchant/sender) maps to returned.

Related ResourcesCopy Anchor Link

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