---
title: "List all trackings"
method: GET
path: "/shipping/{connection_id}/tracking"
tags: ["shipping", "tracking"]
---

# List all trackings

`GET /shipping/{connection_id}/tracking`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/shipping/{connection_id}/tracking`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required

## Query parameters

- `limit` number
- `offset` number
- `updated_gte` string, date-time
- `sort` 'name' | 'updated_at' | 'created_at'
- `order` 'asc' | 'desc'
- `query` string
- `order_id` string
- `fields` string[]
- `raw` string

## Response `200`

Successful

- ShippingTracking[]
  - `id` string: Unique identifier for this tracking object
  - `created_at` string, date-time: The date that this tracking object was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: The last date that this tracking object was updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `shipment_id` string: Reference to the shipment
  - `tracking_number` string: Tracking number for the shipment
  - `status` 'PENDING' | 'PROCESSING' | 'IN_TRANSIT' | 'DELIVERED' | 'EXCEPTION' | 'CANCELLED' | 'LABEL_CREATED' | 'PICKED_UP' | 'OUT_FOR_DELIVERY' | 'DELIVERY_ATTEMPTED' | 'RETURNED_TO_SENDER' | 'HELD_AT_LOCATION' | 'CUSTOMS_CLEARANCE' | 'EXCEPTION_RESOLVED': Current status of the shipment
  - `events` ShippingTrackingEvent[]: Array of tracking events
    - `created_at` string, date-time: The date that this tracking event object was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `description` string: Description of the tracking event
    - `status` 'PENDING' | 'PROCESSING' | 'IN_TRANSIT' | 'DELIVERED' | 'EXCEPTION' | 'CANCELLED' | 'LABEL_CREATED' | 'PICKED_UP' | 'OUT_FOR_DELIVERY' | 'DELIVERY_ATTEMPTED' | 'RETURNED_TO_SENDER' | 'HELD_AT_LOCATION' | 'CUSTOMS_CLEARANCE' | 'EXCEPTION_RESOLVED': Status at the time of this event
    - `event_code` string: Carrier-specific event code
    - `carrier_status_code` string: Carrier's status code at this event
    - `location_address` ShippingTrackingEventLocationAddress
      - `address1` string
      - `address2` string
      - `city` string
      - `region` string
      - `region_code` string
      - `postal_code` string
      - `country` string
      - `country_code` string: ISO 2-digit country code
      - `name` string: Recipientsender name
      - `company_name` string: Company name (for commercial addresses)
      - `telephone` string: Phone number (required by FedEx, UPS, DHL)
      - `email` string: Email address (for delivery notifications)
      - `is_residential` boolean: Alias for address_type === 'RESIDENTIAL'
      - `is_validated` boolean: Whether address has been validated
      - `delivery_instructions` string: Special delivery notes
    - `location_id` string: Location ID; points to CommerceLocation (reference to ShippingLocation)
    - `location_name` string: Location name
    - `notes` string: Additional notes
    - `signed_by` string: Who signed for delivery
  - `estimated_delivery` string, date-time: Estimated delivery date
  - `actual_delivery_at` string, date-time: Actual delivery timestamp (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `status_description` string: Human-readable status
  - `carrier_id` string: Reference to the carrier
  - `carrier_status_code` string: Carrier's status code
  - `carrier_status_description` string: Carrier's status description
  - `metadata` ShippingMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)