FedEx - Track Shipment

Description

This module queries the tracking status of a shipment in FedEx using the tracking number. It makes a POST request to the /track/v1/trackingnumbers endpoint with detailed scans enabled. It processes the response to extract the current status, status code, estimated delivery date, service type, and the complete event history with date, description, city, state, and country.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	FedEx credential (provider: fedex)
tracking_number	text	Yes	FedEx shipment tracking number

Credentials

A fedex type credential is required with the following fields:

client_id: FedEx API Client ID
client_secret: FedEx API Client Secret

Output

{
  "success": true,
  "tracking_number": "794644790138",
  "status": "In Transit",
  "status_code": "IT",
  "estimated_delivery": "2026-03-25T18:00:00",
  "service_type": "FEDEX_INTERNATIONAL_PRIORITY",
  "events": [
    {
      "date": "2026-03-23T10:30:00",
      "event": "Picked up",
      "city": "Madrid",
      "state": "MD",
      "country": "ES"
    }
  ],
  "message": "Estado: In Transit"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_fedex",
  "tracking_number": "794644790138"
}

API Used

Endpoint: POST /track/v1/trackingnumbers
Base: FedEx API (via helper _fedexHelper)
Documentation: https://developer.fedex.com/api/en-us/catalog.html

Notes

Detailed scans are included (includeDetailedScans: true) to obtain the complete history
The FedEx tracking API uses POST instead of GET
Events include broken-down location information (city, state, country)