---
title: "Get freight shipment tracking"
method: GET
path: "/v1/freight/shipments/{freight_shipment_id}/tracking"
tags: ["freight"]
---

# Get freight shipment tracking

`GET /v1/freight/shipments/{freight_shipment_id}/tracking`

Retrieve the current tracking status and event history for a booked freight shipment directly from the carrier.

The shipment is tracked by its PRO number when one has been assigned, and by its BOL number otherwise. A shipment that has neither returns a `400 Bad Request` with error code `freight_tracking_not_available` — this is normal immediately after booking, before the carrier assigns a PRO number.

## Response `200`

The request was a success.

- FreightShipmentTrackingResponseBody — Live carrier tracking for a booked freight shipment.
  - `freight_shipment_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
  - `freight_provider_account_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
  - `freight_provider_name` string — The code of the freight provider used to retrieve the tracking.
  - `carrier_scac` string, nullable — The SCAC of the LTL carrier moving the freight.
  - `bol_number` string, nullable — The Bill of Lading number of the shipment.
  - `pro_number` string, nullable — The carrier's PRO number for the shipment, or `null` until the carrier assigns one.
  - `status` 'pending' | 'quoted' | 'booked' | 'in_transit' | 'delivered' | 'cancelled' | 'exception' — The lifecycle status of a freight shipment. `exception` is also returned when the status cannot be determined.
  - `tracking_status` 'unknown' | 'created' | 'pending_pickup' | 'dispatched' | 'in_route_to_pickup' | 'at_pickup' | 'in_transit' | 'out_for_delivery' | 'at_delivery' | 'delivered' | 'exception' | 'voided' | 'null', nullable — The detailed tracking status reported by the carrier. `tracking_status` is finer-grained than `status`: several tracking statuses, such as `dispatched` and `out_for_delivery`, all map to the `in_transit` shipment status.
  - `estimated_delivery_date` string, nullable — The carrier's estimated delivery date, in `YYYY-MM-DD` format.
  - `tracking_url` string, nullable — A carrier page where the shipment can be tracked, when the carrier provides one.
  - `last_event_at` string, nullable — When the most recent tracking event occurred.
  - `events` FreightTrackingEvent[] — The tracking events reported by the carrier.
    - `occurred_at` string, nullable — When the event occurred, in `YYYY-MM-DDTHH:mm:ssZ` format. Carriers that report only a date return midnight as the time.
    - `status` string, nullable — The tracking status the event corresponds to.
    - `carrier_code` string, nullable — The carrier's own status or event code.
    - `description` string, nullable — The carrier's description of the event.
    - `documents` FreightTrackingEventDocument[] — Any documents the carrier attached to the event, such as a proof of delivery. Always present; an empty array when the carrier attached none.
      - `type` string, nullable — The type of document, as reported by the carrier.
      - `filename` string, nullable — The name of the document file.
      - `format` string, nullable — The file format of the document.

## Other responses

- `400` — The freight shipment ID is malformed, the shipment has no PRO or BOL number to track yet (`freight_tracking_not_available`), or the freight provider connection is not active (`freight_connection_inactive`).
- `404` — The freight shipment does not exist on this account (`freight_shipment_not_found`), or the carrier returned no tracking information (`freight_tracking_not_found`).
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

---

[API](https://skmtc.net/shipstation/apis/shipengine-api.md) · [All operations](https://skmtc.net/shipstation/apis/shipengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipengine-api/revisions/8d8a7cf79204/schema)