> ## Documentation Index
> Fetch the complete documentation index at: https://help.ship.uniuni.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracking

> Track shipments using the UniUni Partner API

Retrieve the current status and event history for a shipment.

## Request

```
GET /track?trackingId=<trackingId>
```

| Header          | Value                  |
| --------------- | ---------------------- |
| `Authorization` | `Bearer <accessToken>` |

### Query parameters

| Parameter    | Type   | Required | Description                                                           |
| ------------ | ------ | -------- | --------------------------------------------------------------------- |
| `trackingId` | string | Yes      | Shipment tracking ID (format: `UR` + 17 digits, or `URB` + 16 digits) |

## Response

```json theme={null}
{
  "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](/en/api/shipment-status-reference).

## Error responses

<Tabs>
  <Tab title="Expired Token">
    ```json theme={null}
    {
      "success": false,
      "message": "TokenExpiredError",
      "errorCode": "TokenExpiredError"
    }
    ```
  </Tab>

  <Tab title="Shipment Not Found">
    ```json theme={null}
    {
      "success": false,
      "message": "Shipment not found",
      "errorCode": "ShipmentNotFoundError"
    }
    ```
  </Tab>
</Tabs>