# RAM Hand-to-Hand Couriers Tracking API & MCP

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

Track **RAM Hand-to-Hand Couriers** (South Africa) waybills with scans in South African time. Query live status, scan history and normalized fields in a single synchronous `GET` request or MCP tool call.

## Overview & Quick Facts

| Property | Value |
|---|---|
| **Carrier slug (`?carrier=`)** | `ramh2h` |
| **Brand aliases** | RAM Hand-to-Hand Couriers, RAM, RAM Couriers, Ram Hand to Hand |
| **Category** | Regional courier (ZA) |
| **Source** | RAM tracking JSON (`GET www.ram.co.za/api/track/{waybill}`) |
| **Single-package REST endpoint** | `GET https://api.lastscanned.com/v1/track/{trackingNumber}` |
| **Batch REST endpoint** | `GET https://api.lastscanned.com/v1/track?numbers=K3081510,...` |
| **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`)** | `/^RAM\d{8}$/` | none | `K3081510` |
| **Pass 2 (`mayMatch`)** | none | none | none |

This shape belongs to RAM Hand-to-Hand Couriers alone, so `?carrier=ramh2h` is optional.

## Synchronous `GET` Request & Normalized JSON Response

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

```json
{
  "carrier": "ramh2h",
  "trackingNumber": "K3081510",
  "status": "delivered",
  "statusDescription": "POD CAPTURED IN Sandton, Johannesburg.",
  "service": null,
  "deliveredAt": "2022-03-30T08:54:00Z",
  "deliveredAtLocal": "2022-03-30T10:54:00",
  "signedBy": "A RECEIVER",
  "destination": null,
  "events": [
    {
      "timestamp": "2022-03-30T17:42:00Z",
      "localTime": "2022-03-30T19:42:00",
      "status": "delivered",
      "description": "POD CAPTURED IN Sandton, Johannesburg.",
      "location": "Sandton, Johannesburg",
      "code": null
    },
    {
      "timestamp": "2022-03-30T08:54:00Z",
      "localTime": "2022-03-30T10:54:00",
      "status": "delivered",
      "description": "DELIVERED, RECEIVED BY A RECEIVER.",
      "location": null,
      "code": null
    },
    {
      "timestamp": "2022-03-30T05:18:00Z",
      "localTime": "2022-03-30T07:18:00",
      "status": "out_for_delivery",
      "description": "OUT FOR DELIVERY IN Sandton, Johannesburg.",
      "location": "Sandton, Johannesburg",
      "code": null
    },
    {
      "timestamp": "2022-03-23T09:48:00Z",
      "localTime": "2022-03-23T11:48:00",
      "status": "label_created",
      "description": "CONSIGNED IN Client Site.",
      "location": "Client Site",
      "code": null
    }
  ]
}
```

## Notes

- **Number format**: only `RAM` plus eight digits is auto-detected; short `K…` waybills need `?carrier=ramh2h`.
- **Call log**: outgoing/incoming call, SMS and email notes in the waybill log are left out; only scans are returned.
- **Time zone**: South Africa is one zone (Africa/Johannesburg).

## Related Resources

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