Skip to main content
Retrieve the current status and event history for a shipment.

​
Request

GET /track?trackingId=<trackingId>
HeaderValue
AuthorizationBearer <accessToken>

​
Query parameters

ParameterTypeRequiredDescription
trackingIdstringYesShipment tracking ID (format: UR + 17 digits, or URB + 16 digits)

​
Response

{
  "success": true,
  "message": "Success",
  "data": {
    "trackingId": "UR12345678901234567",
    "shipmentStatus": "OUT_FOR_DELIVERY",
    "statusCode": 201,
    "orderNumber": "ORD-2026-001",
    "batchId": "URB1234567890123456",
    "note": "",
    "signatureRequired": false,
    "weight": {
      "value": 2.5,
      "weightUnit": "kg"
    },
    "dimensions": {
      "length": 30,
      "width": 20,
      "height": 15,
      "dimensionUnit": "cm"
    },
    "recipient": {
      "fullName": "John Doe",
      "phone": "604-555-0123",
      "email": "john@example.com"
    },
    "destination": {
      "address1": "123 Main St",
      "address2": "Suite 100",
      "city": "Vancouver",
      "province": "BC",
      "postalCode": "V6B 1A1",
      "country": "CA",
      "latitude": 43.6426,
      "longitude": -79.3871
    },
    "events": [
      {
        "status": "OUT_FOR_DELIVERY",
        "statusCode": 201,
        "timestamp": 1773066600000,
        "description": "Package is out for delivery",
        "location": {
          "name": "Toronto Warehouse",
          "lat": 43.7,
          "lng": -79.4
        }
      },
      {
        "status": "RECEIVED",
        "statusCode": 191,
        "timestamp": 1772956800000,
        "description": "Package received at facility",
        "location": {
          "name": "Toronto Warehouse",
          "lat": 43.7,
          "lng": -79.4
        }
      },
      {
        "status": "PENDING",
        "statusCode": 181,
        "timestamp": 1772899200000,
        "description": "",
        "location": null
      }
    ]
  }
}
For the full list of shipmentStatus and statusCode values, see Shipment Status Reference.

​
Error responses

{
  "success": false,
  "message": "TokenExpiredError",
  "errorCode": "TokenExpiredError"
}