Shipments

Get the route, tracking events and ETA revisions of a shipment

Use this to answer "where is it and what happened" and "how has the ETA moved". Returns the route legs in order, every tracking event (both events that happened and estimated ones, oldest first) and every recorded revision of the estimated arrival, oldest first. Not paged.

get/shipments/{shipment_id}/timeline

Request

  • Base URL: https://trackberry.com/api/v1
  • URL: https://trackberry.com/api/v1/shipments/{shipment_id}/timeline
  • Auth: HTTP bearer

Path parameters

shipment_idstring required

The shipment id (shp_ prefix). An id from another organization, or with another prefix, is a 404.

Headers

Trackberry-Versionstring

The API version to build this response for, for example 2026-10-01. Optional: without it the organization's pinned version is used (and the organization is pinned to the latest version on its first request without the header). Applies to this request only. An unpublished version is a 400 with code invalid_version.

Response

The timeline of the shipment.

object'timeline' required

Always timeline.

shipment_idstring required

The shipment this timeline belongs to.

Changes

No recorded changes to this operation across all 1 revision of this API.