Shippo - Track Shipment

Description

This module gets the tracking status of a shipment in Shippo using the carrier code and tracking number. It makes a GET request to the /tracks/{carrier}/{tracking_number} endpoint and processes the response to extract the current status, status details, date, ETA, origin and destination addresses, and the complete tracking history with status, details, date, and location.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Shippo credential (provider: shippo)
carrier	select	Yes	Carrier code: usps, fedex, ups, dhl_express, dhl_ecommerce, canada_post, royal_mail, correos, deutsche_post, gls_de, dpd_de, hermes_de, mondialrelay, seur
tracking_number	text	Yes	Shipment tracking number

Credentials

A shippo type credential is required with the following fields:

api_token: Shippo API Token

Output

{
  "success": true,
  "tracking_number": "9400111899223456789012",
  "carrier": "usps",
  "status": "TRANSIT",
  "status_details": "Your shipment has departed the origin.",
  "status_date": "2026-03-23T10:30:00Z",
  "eta": "2026-03-25T18:00:00Z",
  "address_from": {"city": "San Francisco", "state": "CA", "country": "US"},
  "address_to": {"city": "Los Angeles", "state": "CA", "country": "US"},
  "tracking_history": [
    {
      "status": "TRANSIT",
      "status_details": "Your shipment has departed the origin.",
      "status_date": "2026-03-23T10:30:00Z",
      "location": {"city": "San Francisco", "state": "CA"}
    }
  ],
  "message": "Estado: TRANSIT - Your shipment has departed the origin."
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_shippo",
  "carrier": "usps",
  "tracking_number": "9400111899223456789012"
}

API Used

Endpoint: GET /tracks/{carrier}/{tracking_number}
Base: Shippo API (via helper _shippoHelper)
Documentation: https://goshippo.com/docs/

Notes

The carrier code must match Shippo’s codes (e.g.: usps, fedex, ups)
Shippo supports tracking from more than 60 international carriers
The tracking history includes detailed locations for each event
Possible statuses include: UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE