# TFM Express Tracking API & MCP

URL: https://docs.lastscanned.com/carriers/tfmexpress

Query live **TFM Express** (`tfmexpress`) package status and scan history in a single synchronous `GET` request or MCP tool call. Pass `?carrier=tfmexpress` (or the MCP `carrier` argument) so the lookup goes to TFM Express.

## Overview & Quick Facts

| Property | Value |
|---|---|
| **Carrier slug (`?carrier=`)** | `tfmexpress` |
| **Brand aliases** | TFM Express, TFM, TFMEX, tfmex.com |
| **Category** | Regional (express courier, UAE) |
| **Single-package REST endpoint** | `GET https://api.lastscanned.com/v1/track/{trackingNumber}` |
| **Batch REST endpoint** | `GET https://api.lastscanned.com/v1/track?numbers=971700329734,...` |
| **MCP server (`https://mcp.lastscanned.com`)** | `track_package`, `track_packages`, `list_carriers` |
| **Authentication & pricing** | `Authorization: Bearer lsk_live_...` · 1 free keyless lookup/day per IP |

## Tracking Number Formats & Auto-Detection

| Pass | Rule / Regex | Check Digit | Examples |
|---|---|---|---|
| **Pass 1 (`matches`)** | none | none | none |
| **Pass 2 (`mayMatch`)** | none | none | none |

Twelve-digit airwaybills are a shape other carriers also use, so pass `?carrier=tfmexpress`. Accepted shape: `^\d{12}$`.

## Synchronous `GET` Request & Normalized JSON Response

```bash
curl -s "https://api.lastscanned.com/v1/track/971700329734?carrier=tfmexpress" \
  -H "Authorization: Bearer $LASTSCANNED_API_KEY"
```

```json
{
  "carrier": "tfmexpress",
  "trackingNumber": "971700329734",
  "status": "delivered",
  "statusDescription": "Shipment delivered to Consignee",
  "service": null,
  "deliveredAt": "2026-03-12T11:06:00Z",
  "deliveredAtLocal": "2026-03-12T15:06:00",
  "signedBy": null,
  "destination": null,
  "events": [
    {
      "timestamp": "2026-03-12T11:06:00Z",
      "localTime": "2026-03-12T15:06:00",
      "status": "delivered",
      "description": "Shipment delivered to Consignee",
      "location": null,
      "code": null
    },
    {
      "timestamp": "2026-03-12T06:46:00Z",
      "localTime": "2026-03-12T10:46:00",
      "status": "out_for_delivery",
      "description": "Shipment Out for Delivery",
      "location": null,
      "code": null
    },
    {
      "timestamp": "2026-03-11T19:18:00Z",
      "localTime": "2026-03-11T23:18:00",
      "status": "in_transit",
      "description": "Received at HUB",
      "location": null,
      "code": null
    },
    {
      "timestamp": "2026-03-11T13:39:00Z",
      "localTime": "2026-03-11T17:39:00",
      "status": "label_created",
      "description": "Shipment Created",
      "location": null,
      "code": null
    }
  ]
}
```

## Notes

- **Time zone**: the page's `clientTimeZoneOffSetHour` field is sent as `4`, so it prints Gulf time (the UAE has no DST). `timestamp` is that time at +04:00.
- **Activity**: `description` is the History table's Activity column (for example `Not at Home/Office`); a failed attempt reports `exception`.

## Related Resources

- **Regex & check digits**: [Tracking number formats & auto-detection](/formats)